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
issmbd
, all smbd processes will receive the message. Ifprocess
isnmbd
, only the main nmbd process (identified by Samba’snmbd.pid
file) receives the message. Ifprocess
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, ...
Get Using Samba, Second Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.