SMBRUN(1)

NAME
smbrun - interface program between smbd and external programs

SYNOPSIS
smbrun shell-command

DESCRIPTION
This program is part of the Samba suite. smbrun is a very small 'glue' program, which runs shell commands for the smbd daemon (see smbd(8)). It first changes to the highest effective user and group ID that it can, then runs the command line provided using the system() call. This program is necessary to allow some operating systems to run external programs as non-root.

OPTIONS
shell-command
    The shell command to execute. The command should have a fully-qualified path.

ENVIRONMENT VARIABLES
The PATH variable set for the environment in which smbrun is executed will affect what executables are located and executed if a fully-qualified path is not given in the command.

INSTALLATION
The location of the server and its support files is a matter for individual system administrators. The following are thus suggestions only. It is recommended that the smbrun program be installed under the /usr/local/samba hierarchy, in a directory readable by all, writeable only by root. The program should be executable by all. The program should NOT be setuid or setgid!

VERSION
This man page is (mostly) correct for version 1.9.00 of the Samba suite, plus some of the recent patches to it. These notes will necessarily lag behind development of the software, so it is possible that your version of the program has extensions or parameter semantics that differ from or are not covered by this man page. Please notify these to the address below for rectification.

SEE ALSO
smbd(8), smb.conf(8)

DIAGNOSTICS
If smbrun cannot be located or cannot be executed by smbd then appropriate messages will be found in the smbd logs. Other diagnostics are dependent on the shell-command being run. It is advisable for your shell commands to issue suitable diagnostics to aid trouble-shooting.

BUGS
None known.

CREDITS
The original Samba software and related utilities were created by Andrew Tridgell (samba-bugs@samba.anu.edu.au). Andrew is also the Keeper of the Source for this project. This man page was written by Karl Auer. Bug reports to samba-bugs@anu.edu.au. See smb.conf(5) for a full list of contributors and details of how to submit bug reports, comments etc.