2 .\" This manpage is copyright, like the rest of userv, - see the
3 .\" copyright section, below.
9 .Nd supply user services
15 is the daemon called by
17 to have a task performed under different userid while
18 maintaining limited trust between caller and callee.
20 There is one optional argument:
23 Requests that the program daemonise. If this flag is supplied,
25 will fork and completely detach from the controlling terminal.
26 If this option is not supplied,
28 will remain in its starting process group and continue to use the
29 supplied stderr stream for any runtime system messages; this is useful
37 itself will be reported via
43 issues diagnostics of various kinds to syslog, with facility
45 The syslog levels used are:
48 Verbose messages about the activity of the userv daemon.
50 Two log messages about the nature and outcome of each request.
52 Messages about the status of the daemon, including the
53 startup message and the hourly socket check messages.
55 If the uservd exits because it believes that it no longer controls the
56 rendezvous socket (ie, its socket has become orphaned), this level
57 will receive messages indicating why the daemon believes this and
58 notifying of its shutdown.
60 A believed-recoverable error condition was detected by the userv
61 server in itself, the client or the operating system (this includes
62 resource shortages). The uservd will try to continue.
64 The uservd detected a non-recoverable error condition after startup
72 The service configuration language has the facility to direct error
73 and warning messages to syslog. The default facility and level is
75 but the author of the configuration file(s) can override this.
77 The daemon's exit code will reflect how well things went:
80 The daemon was asked to detach itself from the controlling
81 terminal and this appears to have been done successfully.
83 The daemon got a SIGTERM or SIGINT and shut itself down.
85 The daemon believed that it was no longer the uservd and so exited to
88 uservd was started with incorrect arguments.
90 A system call failure or other environmental problem occurred
93 There was a non-recoverable error after startup; the uservd had
96 The daemon was asked to detach itself, but its detaching child
97 died for some unexpected reason.
98 .It Nm SIGABRT/SIGIOT*
99 An unexpected internal error, usually caused by a bug in uservd. This
100 can also occur if an attempt to block signals using sigprocmask fails.
103 Outcomes marked * are not possible if the daemon is asked to detach
104 itself - these exit statuses will be reaped by init instead and so
105 will not usually be logged anywhere.
107 The daemon's per-request children will report the success or otherwise
108 of its request in their exit status. These are not usually be logged
109 unless they indicate a serious problem.
111 All of the environment variables passed to
113 will be inherited by services as part of the default environment.
116 configuration directive is used, then other system configuration files
117 can modify the environment. Consult the specification.)
122 .%T "User service daemon and client specification"
126 GNU userv, including this manpage, is Copyright (C)1996-2003,2006 Ian
127 Jackson, except that the
129 manpage is Copyright (C)2000 Ben Harris and Copyright (C)2003 Ian
132 GNU userv is licensed under the terms of the GNU General Public
133 Licence, version 2 or (at your option) any later version, and it comes
134 with NO WARRANTY, not even the implied warranty of MERCHANTABILITY or
135 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
138 You should have received a copy of the GNU General Public License
139 along with userv, if not, write to the Free Software Foundation, 59
140 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
143 was initially written in 1996 by Ian Jackson. It became
146 in 1999, and version 1.0 was released in 2000.