launchd-152.tar.gz

[apple/launchd.git] / launchd / src / launchd.8

diff --git a/launchd/src/launchd.8 b/launchd/src/launchd.8
index 5938eae36ed5e36facb2a5cdeb8171b57447fbc3..30e91456fe6136d1bc4940fa8cfdb8d1dff2d260 100644 (file)
--- a/launchd/src/launchd.8
+++ b/launchd/src/launchd.8
@@ -7,15 +7,20 @@
 .Sh SYNOPSIS
 .Nm
 .Op Fl d
-.Op Fl v
+.Op Fl D
 .Op Fl s
-.Op Fl x
+.Op Fl S Ar SessionType
 .Op Ar -- command Op Ar args ...
 .Sh DESCRIPTION
 .Nm 
-manages daemons, both for the system as a whole and for individual users. Ideal daemons can launch
-on demand based on criteria specified in their respective XML property lists located in one of the
-directories specified in the FILES section.
+manages processes, both for the system as a whole and for individual users.
+The primary and preferred interface to
+.Nm
+is via the
+.Xr launchctl 1
+tool which (among other options) allows the user or administrator to load and unload jobs.
+Where possible, it is preferable for jobs to launch on demand based on criteria specified
+in their respective configuration files.
 .Pp
 When run with a command, a specific instance of
 .Nm
@@ -30,18 +35,23 @@ instance of
 During boot 
 .Nm
 is invoked by the kernel to run as the first process on the system and to further bootstrap the rest of the system.
-.Sh OPTIONS WHEN RUN AS PID 1
+.Sh OPTIONS
 .Bl -tag -width -indent
 .It Fl d
 Daemonize. Useful when passing a command to launchd on the command line.
-.It Fl v
-Verbose boot.
+.It Fl D
+Debug. Prints syslog messages to stderr and adjusts logging via
+.Xr syslog 3
+to LOG_DEBUG.
+.It Fl S Ar SessionType
+Instruct launchd to which session type it is.
+.El
+.Sh OPTIONS WHEN RUN AS PID 1
+.Bl -tag -width -indent
 .It Fl s
 Single user mode. Instructs
 .Nm launchd
 to give a shell prompt before booting the system.
-.It Fl x
-Safe mode boot. Instructs the system to boot conservatively.
 .El
 .Sh ENVIRONMENTAL VARIABLES
 .Bl -tag -width -indent