fixed bad link noticed by Martin Schwenke
[Samba.git] / docs / manpages / smbrun.1
blobc671a505aee78ba99add052d771d98c9748e2fb8
1 .\" This manpage has been automatically generated by docbook2man-spec
2 .\" from a DocBook document.  docbook2man-spec can be found at:
3 .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> 
4 .\" Please send any bug reports, improvements, comments, patches, 
5 .\" etc. to Steve Cheng <steve@ggi-project.org>.
6 .TH SMBRUN 1 "24 Mar 2001" "smbrun 2.2.0-alpha3"
7 .SH NAME
8 smbrun \- interface program between smbd and external  programs
9 .SH SYNOPSIS
10 .sp
11 \fBsmbrun\fR \fB<shell command>\fR
12 .SH "DESCRIPTION"
13 .PP
14 This tool is part of the  Sambasuite.
15 .PP
16 \fBsmbrun\fR is a very small 'glue' program, 
17 which runs shell commands for the \fB smbd(8)\fRdaemon.
18 .PP
19 It first changes to the highest effective user and group 
20 ID that it can, then runs the command line provided using the 
21 system() call. This program is necessary to allow some operating 
22 systems to run external programs as non-root.
23 .SH "OPTIONS"
24 .TP
25 \fBshell command\fR
26 The shell command to execute. The 
27 command should have a fully-qualified path.
28 .SH "ENVIRONMENT VARIABLES"
29 .PP
30 The \fIPATH\fR variable set for the 
31 environment in which \fBsmbrun\fR is executed will affect 
32 what executables are located and executed if a fully-qualified path
33 is not given in the command.
34 .SH "DIAGNOSTICS"
35 .PP
36 If \fBsmbrun\fR cannot be located or cannot 
37 be executed by \fBsmbd(8)\fR
38 , then appropriate messages will be found in the \fB smbd\fR logs. Other diagnostics are dependent on the shell-command 
39 being run. It is advisable for your shell commands to issue suitable 
40 diagnostics to aid trouble-shooting.
41 .SH "VERSION"
42 .PP
43 This man page is correct for version 2.2 of 
44 the Samba suite.
45 .SH "SEE ALSO"
46 .PP
47 \fBnmbd(8)\fR, 
48 \fBsmbclient(1)
49 \fR.SH "AUTHOR"
50 .PP
51 The original Samba software and related utilities 
52 were created by Andrew Tridgell. Samba is now developed
53 by the Samba Team as an Open Source project similar 
54 to the way the Linux kernel is developed.
55 .PP
56 The original Samba man pages were written by Karl Auer. 
57 The man page sources were converted to YODL format (another 
58 excellent piece of Open Source software, available at
59 ftp://ftp.icce.rug.nl/pub/unix/ <URL:ftp://ftp.icce.rug.nl/pub/unix/>) and updated for the Samba 2.0 
60 release by Jeremy Allison. The conversion to DocBook for 
61 Samba 2.2 was done by Gerald Carter