smbsh (1)


23 Oct 1998


smbsh - Allows access to Windows NT filesystem using UNIX commands




This program is part of the Samba suite.

smbsh allows you to access an NT filesystem using UNIX commands such as ls, egrep, and rcp. You must use a shell that is dynmanically linked in order for smbsh to work correctly.

To use the smbsh command, execute smbsh from the prompt and enter the username and password that authenticate you to the machine running the Windows NT operating system.

system% smbsh
Username: user

Any dynamically linked command you execute from this shell will access the /smb directory using the smb protocol. For example, the command

ls /smb

will show all the machines in your workgroup. The command

ls /smb/<machine-name>

will show the share names for that machine. You could then, for example, use the cd command to change directories, vi to edit files, and rcp to copy files.


This man page is correct for the 2.0.3 of the Samba suite.


smbsh works by intercepting the standard libc calls with the dynamically loaded versions in smbwrapper.o. Not all calls have been "wrapped" so some programs may not function correctly under smbsh.

Programs which are not dynamically linked cannot make use of smbsh's functionality. Most versions of UNIX have a file command that will describe how a program was linked.


smb.conf (5), smbd (8).


The original Samba software and related utilities were created by Andrew Tridgell ( Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed.

The original Samba man pages were written by Karl Auer. The man page sources were converted to YODL format (another excellent piece of Open Source software, available at and updated for the Samba2.0 release by Jeremy Allison.

See samba (7) to find out how to get a full list of contributors and details on how to submit bug reports, comments etc.