Skip to content

Defective SMb: A minimalist implementation of a client library for SMBv1 using Plain'Ol C

License

Notifications You must be signed in to change notification settings

videolabs/libdsm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

0f3edc6 · Jan 4, 2024
Jan 4, 2024
Sep 7, 2022
Aug 28, 2017
Apr 8, 2022
Jan 4, 2024
Jan 4, 2024
Jun 13, 2016
May 8, 2016
Nov 30, 2015
Dec 2, 2015
Oct 14, 2014
Jun 2, 2022
Apr 25, 2017
Feb 28, 2020
Feb 2, 2022
Nov 20, 2018
Aug 22, 2022
Mar 3, 2022

Repository files navigation

liBDSM

lib Defective SMb (libDSM) is a SMB protocol client implementation in pure old C, with a lot less features than Samba but with a much simpler, and a more permissive license (currently LGPL + proprietary).

The initial goal of this project is to have a library that can access most SMB shares to read files and that has a license compatible with the iOS/Android/WinRT appstores in order to integrate it into VLC for iOS and VLC for Android.

This library is also licensable under a proprietary license, if LGPL is not good enough for you.

The lib is provided as a static library or as a dynamically linked library. A few useless (yet) utils are also provided, mostly for testing purpose.

Features

Here's a list of the currently supported features:

  • NETBIOS
    • Basic bi-directionnal NETBIOS name resolution
    • Hacky LAN SMB servers discovery (Listing all the smb servers on the LAN, no WINS, etc.)
    • Basic NETBIOS Session transport layer
  • SMB
    • Support only required parts of 'NT LM 0.12' (aka CIFS?) dialect.
    • User based authentication
    • List Shares
    • Browse folders
    • Read file
    • Write file
    • Delete file
    • Delete empty folder
    • Move and rename file/folder
    • Create new folder
    • No copy, lock, RPCs, etc. [Hum... yet]

Support

liBDSM has been tested/reported to work with the following devices/OSes:

  • Windows 7
  • Windows 8/8.1
  • Samba
  • smbX (OSX new smb implementation)
  • QNAP TS-212
  • A cheap NAS whose name i can't remember :)

Feel free to contribute items to this list (or network trace of not working devices)

Building

Requirements

  • A Unix system with a bash-compatible shell
  • C99 C compiler
  • (GNU) Make
  • Autotools
  • libc with iconv
  • getopt_long
  • GNU tasn1 compiler/support library

The build dependencies can be installed on Debian(-based) systems using

sudo apt-get install build-essential autoconf libtool pkg-config libtasn1-3-dev libtasn1-3-bin libbsd-dev

HowTo

$> ./bootstrap
$> ./configure --prefix=/your/prefix
$> make
$> make install # maybe

TODO

  • HEAVILY refactor. Any help is welcome.
  • Support more of the SMBv2 and v3 protocols.

Contributing

  • Fork videolabs/libdsm
  • Make a feature branch
  • Commits your work there
  • Make a pull request
  • ...
  • Profit !