# status this software was written a long time ago and may not compile immediately. contact me if you need help. it can be made to run on at least openbsd & linux. # about samblah is a command-line smb/cifs file transfer client, its functionality resembles that of smbclient(1) which is part of the samba project. samblah provides certain features that smbclient(1) lacks, such as command-line completion, convenient globbing and resuming of transfers. # features - command-line completion allows for completion of commands and, depending on the command, local or remote files. - extensive and completely configurable command-line editing is provided by the readline library, see readline(3) for information on how to configure its behaviour. - globbing is provided for both local and remote files, i.e. patterns containing `*', `?' or `[...]' are replaced with the files they match, matching is done by fnmatch(3). note that globbing is done in a generic manner, not inside each internal command but directly after parsing the command-line, this causes it to work as expected for all commands. - other interesting features include recursive file transfers and listings, resuming of transfers, a nice quoting mechanism and more. # screenshots progressbar while transferring, the progress bar, current size and estimated time of arrival are updated once every second. http://www.xs4all.nl/~mechiel/projects/samblah/screenshots/progressbar.png recursive `get' samblah can retrieve directories recursively. http://www.xs4all.nl/~mechiel/projects/samblah/screenshots/recursive.png resuming a transfer when a the destination file of a transfer already exists, the user is asked whether to overwrite, resume, or skip the transfer. http://www.xs4all.nl/~mechiel/projects/samblah/screenshots/resume.png completion as can be seen in the screenshot, completion is quite useful when navigating. http://www.xs4all.nl/~mechiel/projects/samblah/screenshots/completion.png globbing you can use the wildcards `*', `?' and `[characters]' to match file names. http://www.xs4all.nl/~mechiel/projects/samblah/screenshots/globbing.png # installing samblah needs libreadline and libsmbclient. chances are that libreadline is already installed on your system, if not, you can find it at <http://cnswww.cns.cwru.edu/~chet/readline/rltop.html>. as libreadline is pretty mainstream, installing it should not cause much trouble. libsmbclient is a bit harder. It comes as part of samba, <http://www.samba.org/>. at the moment of writing, samba-2.2.8 is the latest release. the problem is that the Makefile does not build and install libsmbclient correctly. see if your operating system/distribution has a libsmbclient package, that will be the easiest. otherwise, try modifying the Makefile of samba to suit your needs. when you have libreadline and libsmbclient, it is time to compile samblah. edit the Makefile and add the location of the libreadline and libsmbclient header files to the include path. then execute `make'. If this succeeds, there will be a binary `samblah' and a formatted manual page `samblah.0'. to install samblah, copy the binary to somewhere in your path (you might want to strip(1) it first) and copy the manual page (either samblah.1, the raw manual page, or samblah.0, the formatted manual page, possibly compressed) to where your systems keeps manual pages. note that there is no `install' target since there is no way of determining where to install the files. # download note that this software is unmaintained, so don't expect many updates. still, changes can be found here: http://www.ueber.net/code/r/samblah # author & licence this code was written by Mechiel Lukkien <email@example.com> or <firstname.lastname@example.org>. all files in samblah distributions are in the public domain. this means you can do anything with it you want. # thanks helpful people who have provided feedback/bug reports/bug fixes and suggestions for improvements: Ferdi Meijerink, Berteun Damman.