smbcontrol
SMBCONTROL(1) SMBCONTROL(1)
NAME
smbcontrol - send messages to smbd, nmbd or winbindd processes
SYNOPSIS
smbcontrol [ -d <debug level> ] [ -s <smb config file> ] -i
smbcontrol [ -d <debug level> ] [ -s <smb config file> ] destination
message-type [ parameter ]
DESCRIPTION
This tool is part of the Samba suite.
smbcontrol is a very small program, which sends messages to an smbd(8)
an nmbd(8) or a winbindd(8) daemon running on the system.
OPTIONS
-d <debuglevel>
debuglevel is an integer from 0 to 10.
-s <smb.conf>
This parameter specifies the pathname to the Samba configuration
file, smb.conf(5) This file controls all aspects of the Samba
setup on the machine.
-i Run interactively. Individual commands of the form destination
message-type parameters can be entered on STDIN. An empty com-
mand line or a "q" will quit the program.
destination
One of nmbd smbd or a process ID.
The smbd destination causes the message to "broadcast" to all
smbd daemons.
The nmbd destination causes the message to be sent to the nmbd
daemon specified in the nmbd.pid file.
If a single process ID is given, the message is sent to only
that process.
message-type
One of: close-share, debug, force-election, ping , profile,
debuglevel, profilelevel, or printer-notify.
The close-share message-type sends a message to smbd which will
then close the client connections to the named share. Note that
this doesn't affect client connections to any other shares. This
message-type takes an argument of the share name for which
client connections will be closed, or the "*" character which
will close all currently open shares. This may be useful if you
made changes to the access controls on the share. This message
can only be sent to smbd.
The debug message-type allows the debug level to be set to the
value specified by the parameter. This can be sent to any of the
destinations.
The force-election message-type can only be sent to the nmbd
destination. This message causes the nmbd daemon to force a new
browse master election.
The ping message-type sends the number of "ping" messages
specified by the parameter and waits for the same number of
reply "pong" messages. This can be sent to any of the destina-
tions.
The profile message-type sends a message to an smbd to change
the profile settings based on the parameter. The parameter can
be "on" to turn on profile stats collection, "off" to turn off
profile stats collection, "count" to enable only collection of
count stats (time stats are disabled), and "flush" to zero the
current profile stats. This can be sent to any smbd or nmbd des-
tinations.
The debuglevel message-type sends a "request debug level" mes-
sage. The current debug level setting is returned by a "debu-
glevel" message. This can be sent to any of the destinations.
The profilelevel message-type sends a "request profile level"
message. The current profile level setting is returned by a
"profilelevel" message. This can be sent to any smbd or nmbd
destinations.
The printer-notify message-type sends a message to smbd which in
turn sends a printer notify message to any Windows NT clients
connected to a printer. This message-type takes an argument of
the printer name to send notify messages to. This message can
only be sent to smbd.
parameters
any parameters required for the message-type
VERSION
This man page is correct for version 2.2 of the Samba suite.
SEE ALSO
nmbd(8) and smbd(8)
AUTHOR
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 ftp://ftp.icce.rug.nl/pub/unix/
<URL:ftp://ftp.icce.rug.nl/pub/unix/>) and updated for the Samba 2.0
release by Jeremy Allison. The conversion to DocBook for Samba 2.2 was
done by Gerald Carter
19 November 2002 SMBCONTROL(1)
