Debian Codegraph @

upstream/debian-unstable/man1/startpar.1

raw
1 '\" e
2 .\" SuSE man page for startpar
3 .\"
4 .\" Copyright (c) 2003 SuSE Linux AG, Nuernberg, Germany.
5 .\"
6 .\" This program is free software; you can redistribute it and/or modify
7 .\" it under the terms of the GNU General Public License as published by
8 .\" the Free Software Foundation; either version 2, or (at your option)
9 .\" any later version.
10 .\"
11 .\" This program is distributed in the hope that it will be useful,
12 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
13 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 .\" GNU General Public License for more details.
15 .\"
16 .\" You should have received a copy of the GNU General Public License
17 .\" along with this program (see the file COPYING); if not, write to the
18 .\" Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,
19 .\" MA 02110-1301, USA.
20 .\"
21 .\" Author: Michael Schroeder <[email protected]>
22 .\"
23 .TH STARTPAR 1 "Mar 2019"
24 .SH NAME
25 startpar \- start runlevel scripts in parallel
26
27 .SH SYNOPSIS
28 .B startpar
29 .RB [ \-p
30 .IR par ]
31 .RB [ \-i
32 .IR iorate ]
33 .RB [ \-e
34 .IR etcdir ]
35 .RB [ \-n ]
36 .RB [ \-t
37 .IR timeout ]
38 .RB [ \-T
39 .IR global_timeout ]
40 .RB [ \-a
41 .IR arg ]
42 .B prg1
43 .B prg2
44 .B ...
45 .br
46 .B startpar
47 .RB [ \-p
48 .IR par ]
49 .RB [ \-i
50 .IR iorate ]
51 .RB [ \-n ]
52 .RB [ \-t
53 .IR timeout ]
54 .RB [ \-T
55 .IR global_timeout ]
56 .B \-M [
57 .IR boot | start | stop ]
58 .br
59 .B startpar
60 .RB [ \-f ]
61 .br
62 .B startpar
63 .RB [ \-v ]
64
65 .SH DESCRIPTION
66 startpar is used to run multiple run\-level scripts in parallel.
67 The degree of parallelism on one
68 .B CPU
69 can be set with the
70 .B \-p
71 option,
72 the default is full parallelism.
73 An argument to all of the scripts can be provided with the
74 .B \-a
75 option.
76 Processes blocked by pending
77 .B I/O
78 will cause new process creation to be weighted by the iorate factor
79 .IR 800 .
80 To change this factor the option
81 .B \-i
82 can be used to specify another value. The amount
83 .EQ
84 weight = (nblocked times iorate) / 1000
85 .EN
86 will be subtracted from the total number of processes
87 which could be started,
88 where nblocked is the number of processes currently blocked
89 by pending I/O.
90
91 The output of each script is buffered
92 and written
93 when the script exits,
94 so output lines of different scripts won't mix.
95 You can modify this behaviour by setting a timeout.
96
97 The timeout set with the
98 .B \-t
99 option is used as buffer timeout.
100 If the output buffer of a script is not empty
101 and the last output was
102 .I timeout
103 seconds ago,
104 startpar will flush the buffer.
105
106 The
107 .B \-T
108 option timeout works more globally.
109 If no output is printed for more than
110 .I global_timeout
111 seconds,
112 startpar will flush the buffer of the script with the oldest output.
113 Afterwards it will only print output of this script
114 until it is finished.
115
116 When the
117 .B \-n
118 flag is used,
119 output from a running job is prefixed with the name of the program
120 or script being run.
121
122 The
123 .B \-M
124 option switches
125 .B startpar
126 into a
127 .BR make (1)
128 like behaviour.
129 This option takes three different arguments:
130 .IR boot ", " start ", and " stop
131 for reading
132 .IR .depend.boot " or " .depend.start " or " .depend.stop
133 respectively in the directory
134 .IR /etc/init.d/ .
135 By scanning the boot and runlevel scripts in
136 .I /etc/init.d/
137 it then executes the appropriate scripts in parallel.
138
139 The
140 .B \-e
141 option allows the user to set the location of the system's etc configuration
142 directory.
143 The default is to use /etc.
144 Using \-e
145 we can use alternative locations
146 such as /usr/local/etc.
147
148 The
149 .B \-f
150 option causes startpar to copy standard input
151 (stdin)
152 to standard output
153 (stdout)
154 until startpar reaches the end of input
155 or the process is killed.
156 When \-f is used
157 no programs are started
158 and other parameters on the command line are ignored.
159 This option is only kept for legacy purposes.
160
161 The
162 .B \-v
163 option tells startpar to print its name and version number.
164 When the version flag is used,
165 all other command line parameters are ignored.
166 The version number will be printed and startpar then immediately exits.
167
168 .SH FILES
169 .I /etc/init.d/.depend.boot
170 .br
171 .I /etc/init.d/.depend.start
172 .br
173 .I /etc/init.d/.depend.stop
174
175 .SH SEE ALSO
176 .BR init (8),
177 .BR insserv (8),
178
179 .SH COPYRIGHT
180 2003,2004 SuSE Linux AG, Nuernberg, Germany.
181 .br
182 2007 SuSE LINUX Products GmbH, Nuernberg, Germany.
183 .br
184 2019 Jesse Smith
185
186 .SH AUTHOR
187 Michael Schroeder <[email protected]>
188 .br
189 Takashi Iwai <[email protected]>
190 .br
191 Werner Fink <[email protected]>