docs/manpages/smbrun.1

   1 .TH SMBRUN 1 17/1/1995 smbrun smbrun
   2 .SH NAME
   3 smbrun \- interface program between smbd and external programs
   4 .SH SYNOPSIS
   5 .B smbrun
   6 .I shell-command
   7 .SH DESCRIPTION
   8 This program is part of the Samba suite.
   9
  10 .B smbrun
  11 is a very small 'glue' program, which runs shell commands for
  12 the
  13 .B smbd
  14 daemon (see
  15 .B smbd(8)).
  16
  17 It first changes to the highest effective user and group ID that it can,
  18 then runs the command line provided using the system() call. This program is
  19 necessary to allow some operating systems to run external programs as non-root.
  20 .SH OPTIONS
  21 .I shell-command
  22
  23 .RS 3
  24 The shell command to execute.
  25
  26 The command should have a fully-qualified path.
  27 .RE
  28 .SH ENVIRONMENT VARIABLES
  29 The PATH variable set for the environment in which
  30 .B smbrun
  31 is executed will affect what executables are located and executed if a
  32 fully-qualified path is not given in the command.
  33
  34 .SH INSTALLATION
  35 The location of the server and its support files is a matter for individual
  36 system administrators. The following are thus suggestions only.
  37
  38 It is recommended that the
  39 .B smbrun
  40 program be installed under the /usr/local hierarchy, in a directory readable
  41 by all, writeable only by root. The program should be executable by all.
  42 The program should NOT be setuid or setgid!
  43 .SH VERSION
  44 This man page is (mostly) correct for version 1.9.00 of the Samba suite, plus some
  45 of the recent patches to it. These notes will necessarily lag behind
  46 development of the software, so it is possible that your version of
  47 the program has extensions or parameter semantics that differ from or are not
  48 covered by this man page. Please notify these to the address below for
  49 rectification.
  50 .SH SEE ALSO
  51 .B smbd(8),
  52 .B smb.conf(8)
  53 .SH DIAGNOSTICS
  54 If smbrun cannot be located or cannot be executed by
  55 .B smbd
  56 then appropriate messages will be found in the smbd logs. Other diagnostics are
  57 dependent on the shell-command being run. It is advisable for your shell
  58 commands to issue suitable diagnostics to aid trouble-shooting.
  59 .SH BUGS
  60 None known.
  61 .SH CREDITS
  62 The original Samba software and related utilities were created by
  63 Andrew Tridgell (samba-bugs@anu.edu.au). Andrew is also the Keeper
  64 of the Source for this project.
  65
  66 This man page was written by Karl Auer (Karl.Auer@anu.edu.au)
  67
  68 See
  69 .B smb.conf(5) for a full list of contributors and details of how to
  70 submit bug reports, comments etc.