added QNX entry to MIRRORS
[ira/wip.git] / 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.