overby.me
this repo has no description
1.Dd April 12, 2002
2.Dt SystemStarter 8
3.Os Darwin
4.Sh NAME
5.Nm SystemStarter
6.\" The following lines are read in generating the apropos(man -k) database. Use only key
7.\" words here as the database is built based on the words here and in the .ND line.
8.\" Use .Nm macro to designate other names for the documented program.
9.Nd Start, stop, and restart system services
10.Sh SYNOPSIS
11.Nm
12.Op Fl gvxdDqn
13.Op Ar action Op Ar service
14.Sh DESCRIPTION
15The
16.Nm
17utility is deprecated. System services should instead be described by a
18.Xr launchd.plist 5 .
19See
20.Xr launchd 8
21for more details.
22The
23.Nm launchd
24utility is available on Mac OS X 10.4 and later.
25.Pp
26In earlier versions of Mac OS X, the
27.Nm
28utility is used to start, stop, and restart the system services which
29are described in the
30.Pa /Library/StartupItems/
31and
32.Pa /System/Library/StartupItems/
33paths.
34.Pp
35The optional
36.Ar action
37argument specifies which action
38.Nm
39performs on the startup items. The optional
40.Ar service
41argument specifies which startup items to perform the action on. If no
42.Ar service
43is specified, all startup items will be acted on; otherwise, only the item providing the
44.Ar service ,
45any items it requires, or any items that depend on it will be acted on.
46.Pp
47During boot
48.Nm
49is invoked by
50.Xr launchd 8
51and is responsible for
52starting all startup items in an order that satisfies each item's
53requirements.
54.Sh ACTIONS
55.Bl -tag -width -indent
56.It Nm start
57start all items, or start the item that provides the specified
58.Ar service
59and all items providing services it requires.
60.It Nm stop
61stop all items, or stop the item that provides the specified
62.Ar service
63and all items that depend on it.
64.It Nm restart
65restart all items, or restart the item providing the specified
66.Ar service .
67.El
68.Sh OPTIONS
69.Bl -tag -width -indent
70.It Fl g
71(ignored)
72.It Fl v
73verbose (text mode) startup
74.It Fl x
75(ignored)
76.It Fl r
77(ignored)
78.It Fl d
79print debugging output
80.It Fl D
81print debugging output and dependencies
82.It Fl q
83be quiet (disable debugging output)
84.It Fl n
85don't actually perform action on items (no-run mode)
86.El
87.Sh NOTES
88Unless an explicit call to
89.Nm ConsoleMessage
90is made,
91.Nm
92examines the exit status of the startup item scripts to determine the success or failure of the services provided by that script.
93.Pp
94.Sh FILES
95.Bl -tag -width -/System/Library/StartupItems -compact
96.It Pa /Library/StartupItems/
97User-installed startup items.
98.It Pa /System/Library/StartupItems/
99System-provided startup items.
100.El
101.Sh SEE ALSO
102.\" List links in ascending order by section, alphabetically within a section.
103.\" Please do not reference files that do not exist without filing a bug report
104.Xr ConsoleMessage 8 ,
105.Xr launchd 8 ,
106.Xr launchd.plist 5 ,
107.Xr rc 8
108.\" .Sh BUGS \" Document known, unremedied bugs
109.Sh HISTORY
110The
111.Nm
112utility appeared in Darwin 1.0 and
113was extended in Darwin 6.0 to support partial startup and interprocess communication.
114.Nm
115was deprecated by
116.Xr launchd 8
117in Darwin 8.0.