smbcontrol man page on Syllable

Man page or keyword search:  
man Server   2339 pages
apropos Keyword Search (all sections)
Output format
Syllable logo
[printable version]

SMBCONTROL(1)							 SMBCONTROL(1)

NAME
       smbcontrol - send messages to smbd, nmbd or winbindd processes

SYNOPSIS
       smbcontrol [-i] [-s]

       smbcontrol [destination] [message-type] [parameter]

DESCRIPTION
       This tool is part of the samba(7) suite.

       smbcontrol  is a very small program, which sends messages to a smbd(8),
       a nmbd(8), or a winbindd(8) daemon running on the system.

OPTIONS
       -h|--help
	      Print a summary of command line options.

       -s <configuration file>
	      The file specified contains the configuration  details  required
	      by the server. The information in this file includes server-spe‐
	      cific information such as what printcap file to use, as well  as
	      descriptions  of all the services that the server is to provide.
	      See smb.conf for more  information.  The	default	 configuration
	      file name is determined at compile time.

       -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 thenmbd.pid file.

	      If  a  single  process  ID is given, the message is sent to only
	      that process.

       message-type
	      Type of message to send. See the section MESSAGE-TYPES  for  de‐
	      tails.

       parameters
	      any parameters required for the message-type

MESSAGE-TYPES
       Available message types are:

       close-share
	      Order  smbd  to 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 "*"  charac‐
	      ter which will close all currently open shares. This may be use‐
	      ful if you made changes to the access  controls  on  the	share.
	      This message can only be sent to smbd.

       debug  Set  debug  level	 to the value specified by the parameter. This
	      can be sent to any of the destinations.

       force-election
	      This message causes the nmbd daemon to force a new browse master
	      election.

       ping   Send  specified  number of "ping" messages and wait for the same
	      number of reply "pong" messages. This can be sent to any of  the
	      destinations.

       profile
	      Change profile settings of a daemon, 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 destinations.

       debuglevel
	      Request debuglevel of a certain daemon and write it  to  stdout.
	      This can be sent to any of the destinations.

       profilelevel
	      Request profilelevel of a certain daemon and write it to stdout.
	      This can be sent to any smbd or nmbd destinations.

       printnotify
	      Order smbd to send a printer notify message to  any  Windows  NT
	      clients connected to a printer. This message-type takes the fol‐
	      lowing arguments:

	      queuepause printername
		     Send a queue pause change notify message to  the  printer
		     specified.

	      queueresume printername
		     Send a queue resume change notify message for the printer
		     specified.

	      jobpause printername unixjobid
		     Send a job pause change notify message  for  the  printer
		     and unix jobid specified.

	      jobresume printername unixjobid
		     Send  a  job resume change notify message for the printer
		     and unix jobid specified.

	      jobdelete printername unixjobid
		     Send a job delete change notify message for  the  printer
		     and unix jobid specified.

	      Note that this message only sends notification that an event has
	      occured. It doesn't actually cause the event to happen.

	      This message can only be sent to smbd.

       samsync
	      Order smbd to synchronise sam database from PDC (being BDC). Can
	      only be sent to smbd.

	      Note

	      Not working at the moment

       samrepl
	      Send sam replication message, with specified serial. Can only be
	      sent to smbd. Should not be used manually.

       dmalloc-mark
	      Set a mark for dmalloc. Can be sent to both smbd and nmbd.  Only
	      available if samba is built with dmalloc support.

       dmalloc-log-changed
	      Dump  the pointers that have changed since the mark set by dmal‐
	      loc-mark. Can be sent to both smbd and nmbd. Only	 available  if
	      samba is built with dmalloc support.

       shutdown
	      Shut down specified daemon. Can be sent to both smbd and nmbd.

       pool-usage
	      Print  a	human-readable	description of all talloc(pool) memory
	      usage by the specified daemon/process. Available for  both  smbd
	      and nmbd.

       drvupgrade
	      Force clients of printers using specified driver to update their
	      local version of the driver. Can only be sent to smbd.

       reload-config
	      Force daemon to reload smb.conf configuration file. Can be  sent
	      to smbd, nmbd, or winbindd.

VERSION
       This man page is correct for version 3.0 of the Samba suite.

SEE ALSO
       nmbd(8) and smbd(8).

AUTHOR
       The  original  Samba software and related utilities were created by An‐
       drew 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/) and up‐
       dated for the Samba 2.0 release by Jeremy Allison.  The	conversion  to
       DocBook for Samba 2.2 was done by Gerald Carter. The conversion to Doc‐
       Book XML 4.2 for Samba 3.0 was done by Alexander Bokovoy.

								 SMBCONTROL(1)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Syllable

List of man pages available for Syllable

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net