Added link to YODL url.
[samba.git] / docs / manpages / smbrun.1
1 .TH "smbrun" "1" "23 Oct 1998" "Samba" "SAMBA" 
2 .PP 
3 .SH "NAME" 
4 smbrun \- interface program between smbd and external programs
5 .PP 
6 .SH "SYNOPSIS" 
7 .PP 
8 \fBsmbrun\fP shell-command
9 .PP 
10 .SH "DESCRIPTION" 
11 .PP 
12 This program is part of the \fBSamba\fP suite\&.
13 .PP 
14 \fBsmbrun\fP is a very small \'glue\' program, which runs shell commands
15 for the \fBsmbd\fP daemon \fBsmbd
16 (8)\fP\&.
17 .PP 
18 It first changes to the highest effective user and group ID that it
19 can, then runs the command line provided using the system() call\&. This
20 program is necessary to allow some operating systems to run external
21 programs as non-root\&.
22 .PP 
23 .SH "OPTIONS" 
24 .PP 
25 .IP 
26 .IP "\fBshell-command\fP" 
27 The shell command to execute\&.  The command
28 should have a fully-qualified path\&.
29 .IP 
30 .PP 
31 .SH "ENVIRONMENT VARIABLES" 
32 .PP 
33 The \fIPATH\fP variable set for the environment in which \fBsmbrun\fP is
34 executed will affect what executables are located and executed if a
35 fully-qualified path is not given in the command\&.
36 .PP 
37 .SH "DIAGNOSTICS" 
38 .PP 
39 If \fBsmbrun\fP cannot be located or cannot be executed by
40 \fBsmbd\fP then appropriate messages will be found in
41 the \fBsmbd\fP logs\&. Other diagnostics are dependent
42 on the shell-command being run\&. It is advisable for your shell
43 commands to issue suitable diagnostics to aid trouble-shooting\&.
44 .PP 
45 .SH "VERSION" 
46 .PP 
47 This man page is correct for version 2\&.0 of the Samba suite\&.
48 .PP 
49 .SH "SEE ALSO" 
50 .PP 
51 \fBsmb\&.conf (5)\fP, \fBsmbd (8)\fP
52 .PP 
53 .SH "AUTHOR" 
54 .PP 
55 The original Samba software and related utilities were created by
56 Andrew Tridgell \fIsamba-bugs@samba\&.anu\&.edu\&.au\fP\&. Samba is now developed
57 by the Samba Team as an Open Source project similar to the way the
58 Linux kernel is developed\&.
59 .PP 
60 The original Samba man pages were written by Karl Auer\&. The man page
61 sources were converted to YODL format (another excellent piece of Open
62 Source software, available at
63 \fBftp://ftp\&.icce\&.rug\&.nl/pub/unix/\fP)
64 and updated for the Samba2\&.0 release by Jeremy Allison\&.
65 \fIsamba-bugs@samba\&.anu\&.edu\&.au\fP\&.
66 .PP 
67 See \fBsamba (7)\fP to find out how to get a full
68 list of contributors and details on how to submit bug reports,
69 comments etc\&.