libdsm with meson support

Jean-Baptiste Kempf 9894494bcb Update .gitignore for .exe il y a 9 ans
bin fbcfbeb491 lookup: fix headers for Windows il y a 9 ans
compat 0c50ec4e27 compat: Add a strndup replacement il y a 9 ans
contrib 33f4a0e556 Fix libtasn1 version detection. Move tasn1 compat types to config.h il y a 11 ans
doc 425f8c82c4 doxygen: only generate doc for include il y a 10 ans
include 7f4d418a08 Work-around off_t being 32bits on Windows il y a 9 ans
m4 0483435c39 Add -Wall -Wextra to build flags il y a 10 ans
src 1790c4c3d0 smb_file: include config.h il y a 9 ans
www 3a25719776 add www/README il y a 10 ans
.gitignore 9894494bcb Update .gitignore for .exe il y a 9 ans
.mailmap 60744f1558 Update mailmap for macromizer il y a 9 ans
AUTHORS 1fdde416f4 Update AUTHORS il y a 9 ans
COPYING dce710003c Update license and Readme il y a 10 ans
Makefile.am 4dbe222ec4 Add a compatible queue.h when missing il y a 9 ans
NEWS bab631396d Update NEWS il y a 9 ans
NOTES.md 162ab2b352 Fix NOTES.md to actually match markdown syntax il y a 9 ans
README.md 9880bab40b Update Readme il y a 9 ans
abi_version.sh 69bdc304e1 build: Initial autotools il y a 11 ans
bootstrap 70b038c85f allow to run bootstrap from build-folder il y a 9 ans
configure.ac 0c50ec4e27 compat: Add a strndup replacement il y a 9 ans
libdsm.pc.in 12b970c17b Correctly export winsock2 as linking library for Windows il y a 9 ans
package_version.sh 69bdc304e1 build: Initial autotools il y a 11 ans

README.md

liBDSM

lib Defective SMb (libDSM) is a SMB protocol client implementation in pure old C, with a lot less features than Samba but is simpler, and has with 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 with 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 !