Using Samba, Second Edition

Name

smbcontrol

Synopsis

The smbcontrol command sends control messages to running smbd or nmbd processes.

Command synopsis

smbcontrol -i [options]

or:

smbcontrol [options] process message-type [parameters]

Options

-i

Runs smbcontrol interactively, executing commands until a blank line or “q” is read. The user must have superuser privileges.

-s filename

Specifies the location of the Samba configuration file.

-d debuglevel

Sets the debugging level for logging. The debug level can be set from to 10.

Whether smbcontrol commands are issued in interactive mode or from the command line, the commands are in the same format. Each command has up to three parts:

process

Specifies the process or group of processes to which to send the message. If process is smbd, all smbd processes will receive the message. If process is nmbd, only the main nmbd process (identified by Samba’s nmbd.pid file) receives the message. If process is the numeric PID of a running process on the system, that process will receive the message.

message-type

Specifies the type of message that is sent. For more information, see smbcontrol message types that follows.

parameters

Specifies additional parameters required by some messages.

smbcontrol message types

close-share share_name

Closes the connection to a share or shares. If share_name is specified as an asterisk (*), connections to all shares will be closed. To close a single connection, share_name is given as the name of a share, as specified in the Samba configuration file, ...