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