20.11. Samba Distribution Programs

20.11. Samba Distribution Programs

findsmb

findsmb <subnet_broadcast_address>

The findsmb program is a Perl script which reports information about SMB-aware systems on a specific subnet. If no subnet is specified the local subnet is used. Items displayed include IP address, NetBIOS name, workgroup or domain name, operating system, and version.

The following example shows the output of executing findsmb as any valid user on a system:

findsmb   
IP ADDR       NETBIOS NAME  WORKGROUP/OS/VERSION 
------------------------------------------------------------------ 
10.1.59.25    VERVE         [MYGROUP] [Unix] [Samba 3.0.0-15] 
10.1.59.26    STATION22     [MYGROUP] [Unix] [Samba 3.0.2-7.FC1] 
10.1.56.45    TREK         +[WORKGROUP] [Windows 5.0] [Windows 2000 LAN Manager] 
10.1.57.94    PIXEL         [MYGROUP] [Unix] [Samba 3.0.0-15] 
10.1.57.137   MOBILE001     [WORKGROUP] [Windows 5.0] [Windows 2000 LAN Manager] 
10.1.57.141   JAWS         +[KWIKIMART] [Unix] [Samba 2.2.7a-security-rollup-fix] 
10.1.56.159   FRED         +[MYGROUP] [Unix] [Samba 3.0.0-14.3E] 
10.1.59.192   LEGION       *[MYGROUP] [Unix] [Samba 2.2.7-security-rollup-fix] 
10.1.56.205   NANCYN       +[MYGROUP] [Unix] [Samba 2.2.7a-security-rollup-fix]

net

net <protocol> <function> <misc_options> <target_options>

The net utility is similar to the net utility used for Windows and MS-DOS. The first argument is used to specify the protocol to use when executing a command. The <protocol> option can be ads, rap, or rpc for specifying the type of server connection. Active Directory uses ads, Win9x/NT3 uses rap, and Windows NT4/2000/2003 uses rpc. If the protocol is omitted, net automatically tries to determine it.

The following example displays a list the available shares for a host named wakko:

net -l share -S wakko 
Password:   

Enumerating shared resources (exports) on remote server:     

Share name   Type     Description 
----------   ----     ----------- 
data         Disk     Wakko data share 
tmp          Disk     Wakko tmp share 
IPC$         IPC      IPC Service (Samba Server) 
ADMIN$       IPC      IPC Service (Samba Server)

The following example displays a list of Samba users for a host named wakko:

net -l user -S wakko 
root password:   
User name             Comment 
----------------------------- 
andriusb              Documentation 
joe                   Marketing 
lisa                  Sales

nmblookup

nmblookup <options> <netbios_name>

The nmblookup program resolves NetBIOS names into IP addresses. The program broadcasts its query on the local subnet until the target machine replies.

Here is an example:

nmblookup trek 
querying trek on 10.1.59.255 
10.1.56.45 trek<00>

pdbedit

pdbedit <options>

The pdbedit program manages accounts located in the SAM database. All backends are supported including smbpasswd, LDAP, NIS+, and the tdb database library.

The following are examples of adding, deleting, and listing users:

pdbedit -a kristin 
new password: 
retype new password: 
Unix username:        kristin 
NT username: 
Account Flags:        [U          ] 
User SID:             S-1-5-21-1210235352-3804200048-1474496110-2012 
Primary Group SID:    S-1-5-21-1210235352-3804200048-1474496110-2077 
Full Name: Home Directory:       \\wakko\kristin 
HomeDir Drive: 
Logon Script: 
Profile Path:         \\wakko\kristin\profile 
Domain:               WAKKO 
Account desc: 
Workstations: Munged 
dial: 
Logon time:           0 
Logoff time:          Mon, 18 Jan 2038 22:14:07 GMT 
Kickoff time:         Mon, 18 Jan 2038 22:14:07 GMT 
Password last set:    Thu, 29 Jan 2004 08:29:28 
GMT Password can change:  Thu, 29 Jan 2004 08:29:28 GMT 
Password must change: Mon, 18 Jan 2038 22:14:07 GMT  pdbedit -v -L kristin 
Unix username:        kristin 
NT username: 
Account Flags:        [U          ] 
User SID:             S-1-5-21-1210235352-3804200048-1474496110-2012 
Primary Group SID:    S-1-5-21-1210235352-3804200048-1474496110-2077 
Full Name: 
Home Directory:       \\wakko\kristin 
HomeDir Drive: 
Logon Script: 
Profile Path:         \\wakko\kristin\profile 
Domain:               WAKKO 
Account desc: 
Workstations: Munged 
dial: 
Logon time:           0 
Logoff time:          Mon, 18 Jan 2038 22:14:07 GMT 
Kickoff time:         Mon, 18 Jan 2038 22:14:07 GMT 
Password last set:    Thu, 29 Jan 2004 08:29:28 GMT 
Password can change:  Thu, 29 Jan 2004 08:29:28 GMT 
Password must change: Mon, 18 Jan 2038 22:14:07 GMT  pdbedit -L 
andriusb:505: 
joe:503: 
lisa:504: 
kristin:506:  pdbedit -x joe  pdbedit -L 

andriusb:505: lisa:504: kristin:506:

rpcclient

rpcclient <server> <options>

The rpcclient program issues administrative commands using Microsoft RPCs, which provide access to the Windows administration graphical user interfaces (GUIs) for systems management. This is most often used by advanced users that understand the full complexity of Microsoft RPCs.

smbcacls

smbcacls <//server/share> <filename> <options>

The smbcacls program modifies Windows ACLs on files and directories shared by the Samba server.

smbclient

smbclient <//server/share> <password> <options>

The smbclient program is a versatile UNIX client which provides functionality similar to ftp.

smbcontrol

smbcontrol -i <options>

smbcontrol <options> <destination> <messagetype> <parameters>

The smbcontrol program sends control messages to running smbd or nmbd daemons. Executing smbcontrol -i runs commands interactively until a blank line or a 'q' is entered.

smbpasswd

smbpasswd <options> <username> <password>

The smbpasswd program manages encrypted passwords. This program can be run by a superuser to change any user's password as well as by an ordinary user to change their own Samba password.

smbspool

smbspool <job> <user> <title> <copies> <options> <filename>

The smbspool program is a CUPS-compatible printing interface to Samba. Although designed for use with CUPS printers, smbspool can work with non-CUPS printers as well.

smbstatus

smbstatus <options>

The smbstatus program displays the status of current connections to a Samba server.

smbtar

smbtar <options>

The smbtar program performs backup and restores of Windows-based share files and directories to a local tape archive. Though similar to the tar command, the two are not compatible.

testparm

testparm <options> <filename> <hostname IP_address>

The testparm program checks the syntax of the smb.conf file. If your smb.conf file is in the default location (/etc/samba/smb.conf) you do not need to specify the location. Specifying the hostname and IP address to the testparm program verifies that the hosts.allow and host.deny files are configured correctly. The testparm program also displays a summary of your smb.conf file and the server's role (stand-alone, domain, etc.) after testing. This is convenient when debugging as it excludes comments and concisely presents information for experienced administrators to read.

For example:

testparm 
Load smb config files from /etc/samba/smb.conf 
Processing section "[homes]" 
Processing section "[printers]" 
Processing section "[tmp]" 
Processing section "[html]" 
Loaded services file OK. 
Server role: ROLE_STANDALONE 
Press enter to see a dump of your service definitions <enter> 
# Global parameters 
[global]
	workgroup = MYGROUP         
	server string = Samba Server         
	security = SHARE         
	log file = /var/log/samba/%m.log         
	max log size = 50         
	socket options = TCP_NODELAY SO_RCVBUF=8192 SO_SNDBUF=8192         
	dns proxy = No   
[homes]         
	comment = Home Directories         
	read only = No         
	browseable = No   
[printers]         
	comment = All Printers         
	path = /var/spool/samba         
	printable = Yes         
	browseable = No   
[tmp]         
	comment = Wakko tmp         
	path = /tmp         
	guest only = Yes   
[html]         
	comment = Wakko www         
	path = /var/www/html         
	force user = andriusb         
	force group = users         
	read only = No         
	guest only = Yes

wbinfo

wbinfo <options>

The wbinfo program displays information from the winbindd daemon. The winbindd daemon must be running for wbinfo to work.


Note: This documentation is provided {and copyrighted} by Red Hat®, Inc. and is released via the Open Publication License. The copyright holder has added the further requirement that Distribution of substantively modified versions of this document is prohibited without the explicit permission of the copyright holder. The CentOS project redistributes these original works (in their unmodified form) as a reference for CentOS-5 because CentOS-5 is built from publicly available, open source SRPMS. The documentation is unmodified to be compliant with upstream distribution policy. Neither CentOS-5 nor the CentOS Project are in any way affiliated with or sponsored by Red Hat®, Inc.