diff -r 71503088f51b -r f880f219c566 openpkg/rc.8 --- a/openpkg/rc.8 Tue Jul 31 12:12:54 2012 +0200 +++ b/openpkg/rc.8 Tue Jul 31 12:23:42 2012 +0200 @@ -1,15 +1,7 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 +.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.22) .\" .\" Standard preamble: .\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp @@ -25,11 +17,11 @@ .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. | will give a -.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to -.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' -.\" expand to `' in nroff, nothing in troff, for use with C<>. -.tr \(*W-|\(bv\*(Tr +.\" double quote, and \*(R" will give a right double quote. \*(C+ will +.\" give a nicer C++. Capital omega is used to do unbreakable dashes and +.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, +.\" nothing in troff, for use with C<>. +.tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- @@ -48,22 +40,25 @@ . ds R" '' 'br\} .\" +.\" Escape single quotes in literal strings from groff's Unicode transform. +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" .\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index +.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. -.if \nF \{\ +.ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.hy 0 -.if n .na +.el \{\ +. de IX +.. +.\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. @@ -130,24 +125,28 @@ .\" .IX Title "RC 8" .TH RC 8 "OpenPKG" "RC(8)" "OpenPKG" +.\" For nroff, turn off justification. Always turn off hyphenation; it makes +.\" way too many mistakes in technical documents. +.if n .ad l +.nh .SH "NAME" -\&\fB@l_prefix@/bin/openpkg rc\fR \- OpenPKG Run\-Command Processor +@l_prefix@/bin/openpkg rc \- OpenPKG Run\-Command Processor .SH "SYNOPSIS" .IX Header "SYNOPSIS" -\&\fB@l_prefix@/bin/openpkg rc\fR [\fB\-s\fR|\fB\-\-silent\fR] [\fB\-v\fR|\fB\-\-verbose\fR] [\fB\-d\fR|\fB\-\-debug\fR] [\fB\-k\fR|\fB\-\-keep\fR] \fIpackage\fR \fIcommand\fR [\fIcommand\fR ...] +\&\fB\f(CB@l_prefix\fB@/bin/openpkg rc\fR [\fB\-s\fR|\fB\-\-silent\fR] [\fB\-v\fR|\fB\-\-verbose\fR] [\fB\-d\fR|\fB\-\-debug\fR] [\fB\-k\fR|\fB\-\-keep\fR] [\fB\-D\fR|\fB\-\-define\fR \fIname\fR=\fIvalue\fR] \fIpackage\fR \fIcommand\fR [\fIcommand\fR ...] .PP -\&\fB@l_prefix@/bin/openpkg rc\fR \fB\-p\fR|\fB\-\-print\fR \fIpackage\fR \fIcommand\fR [\fIcommand\fR ...] +\&\fB\f(CB@l_prefix\fB@/bin/openpkg rc\fR \fB\-p\fR|\fB\-\-print\fR \fIpackage\fR \fIcommand\fR [\fIcommand\fR ...] .PP -eval `\fB@l_prefix@/bin/openpkg rc\fR \fB\-e\fR|\fB\-\-eval\fR \fIpackage\fR \fIcommand\fR [\fIcommand\fR ...]` +eval `\fB\f(CB@l_prefix\fB@/bin/openpkg rc\fR \fB\-e\fR|\fB\-\-eval\fR \fIpackage\fR \fIcommand\fR [\fIcommand\fR ...]` .PP -\&\fB@l_prefix@/bin/openpkg rc\fR \fB\-q\fR|\fB\-\-query\fR \fIvariable\fR [\fIvariable\fR ...] +\&\fB\f(CB@l_prefix\fB@/bin/openpkg rc\fR \fB\-q\fR|\fB\-\-query\fR \fIvariable\fR [\fIvariable\fR ...] .PP -\&\fB@l_prefix@/bin/openpkg rc\fR \fB\-c\fR|\fB\-\-config\fR +\&\fB\f(CB@l_prefix\fB@/bin/openpkg rc\fR \fB\-c\fR|\fB\-\-config\fR .PP -\&\fB@l_prefix@/bin/openpkg rc\fR \fB\-h\fR|\fB\-\-help\fR +\&\fB\f(CB@l_prefix\fB@/bin/openpkg rc\fR \fB\-h\fR|\fB\-\-help\fR .SH "DESCRIPTION" .IX Header "DESCRIPTION" -The \fB@l_prefix@/bin/openpkg rc\fR program is the run-command (rc) processor +The \fB\f(CB@l_prefix\fB@/bin/openpkg rc\fR program is the run-command (rc) processor of the \fBOpenPKG\fR instance \f(CW\*(C`@l_prefix@\*(C'\fR. It allows querying the rc configuration variables and the execution of rc command scripts of one or more installed \fBOpenPKG\fR packages. The implemented run-command @@ -157,9 +156,10 @@ procedures with periodical procedures into a single approach. .SH "USAGE" .IX Header "USAGE" -.IP "\fB@l_prefix@/bin/openpkg rc\fR [\fB\-s\fR|\fB\-\-silent\fR] [\fB\-v\fR|\fB\-\-verbose\fR] [\fB\-d\fR|\fB\-\-debug\fR] [\fB\-k\fR|\fB\-\-keep\fR] \fIpackage\fR \fIcommand\fR [\fIcommand\fR ...]" 4 -.IX Item "@l_prefix@/bin/openpkg rc [-s|--silent] [-v|--verbose] [-d|--debug] [-k|--keep] package command [command ...]" -\&\fBRuncommand Execution.\fR This executes one or more specified +.ie n .IP "\fB\fB@l_prefix\fB@/bin/openpkg rc\fR [\fB\-s\fR|\fB\-\-silent\fR] [\fB\-v\fR|\fB\-\-verbose\fR] [\fB\-d\fR|\fB\-\-debug\fR] [\fB\-k\fR|\fB\-\-keep\fR] [\fB\-D\fR|\fB\-\-define\fR \fIname\fR=\fIvalue\fR] \fIpackage\fR \fIcommand\fR [\fIcommand\fR ...]" 4 +.el .IP "\fB\f(CB@l_prefix\fB@/bin/openpkg rc\fR [\fB\-s\fR|\fB\-\-silent\fR] [\fB\-v\fR|\fB\-\-verbose\fR] [\fB\-d\fR|\fB\-\-debug\fR] [\fB\-k\fR|\fB\-\-keep\fR] [\fB\-D\fR|\fB\-\-define\fR \fIname\fR=\fIvalue\fR] \fIpackage\fR \fIcommand\fR [\fIcommand\fR ...]" 4 +.IX Item "@l_prefix@/bin/openpkg rc [-s|--silent] [-v|--verbose] [-d|--debug] [-k|--keep] [-D|--define name=value] package command [command ...]" +\&\fBRun-Command Execution.\fR This executes one or more specified \&\fIcommand\fRs in a particular \fIpackage\fR or in all installed packages if \&\fIpackage\fR is "\f(CW\*(C`all\*(C'\fR". Option \fB\-\-silent\fR can be used to explicitly disable progress messages on \f(CW\*(C`stderr\*(C'\fR. Option \fB\-\-verbose\fR can be used @@ -167,19 +167,23 @@ automatically determines whether progress messages should be displayed or not depending on whether \f(CW\*(C`stderr\*(C'\fR is connected to a terminal device. Option \fB\-\-keep\fR can be used for debugging purposes to keep the -temporary files were generated during internal processing. -.IP "\fB@l_prefix@/bin/openpkg rc\fR \fB\-p\fR|\fB\-\-print\fR \fIpackage\fR \fIcommand\fR [\fIcommand\fR ...]" 4 +temporary files were generated during internal processing. Option +\&\fB\-\-define\fR can be used to on-the-fly re-define a configuration variable +\&\fIname\fR with \fIvalue\fR. +.ie n .IP "\fB\fB@l_prefix\fB@/bin/openpkg rc\fR \fB\-p\fR|\fB\-\-print\fR \fIpackage\fR \fIcommand\fR [\fIcommand\fR ...]" 4 +.el .IP "\fB\f(CB@l_prefix\fB@/bin/openpkg rc\fR \fB\-p\fR|\fB\-\-print\fR \fIpackage\fR \fIcommand\fR [\fIcommand\fR ...]" 4 .IX Item "@l_prefix@/bin/openpkg rc -p|--print package command [command ...]" -\&\fBRuncommand Printing.\fR This is like the run-command execution (see +\&\fBRun-Command Printing.\fR This is like the run-command execution (see above), but instead of immediately executing all involved individual run-command scripts, they are concatenated (but with all configuration parts reduced to a single configuration part) and printed to \f(CW\*(C`stdout\*(C'\fR. Use this for debugging or post-processing purposes. -.IP "eval `\fB@l_prefix@/bin/openpkg rc\fR \fB\-e\fR|\fB\-\-eval\fR \fIpackage\fR \fIcommand\fR [\fIcommand\fR ...]`" 4 +.ie n .IP "eval `\fB\fB@l_prefix\fB@/bin/openpkg rc\fR \fB\-e\fR|\fB\-\-eval\fR \fIpackage\fR \fIcommand\fR [\fIcommand\fR ...]`" 4 +.el .IP "eval `\fB\f(CB@l_prefix\fB@/bin/openpkg rc\fR \fB\-e\fR|\fB\-\-eval\fR \fIpackage\fR \fIcommand\fR [\fIcommand\fR ...]`" 4 .IX Item "eval `@l_prefix@/bin/openpkg rc -e|--eval package command [command ...]`" -\&\fBRuncommand Evaluation.\fR This is like the run-command execution +\&\fBRun-Command Evaluation.\fR This is like the run-command execution (see above), but the resulting exported shell environment variables -are output to a temporary file as a (Bourne\-Shell or C\-Shell syntax) +are output to a temporary file as a (Bourne-Shell or C\-Shell syntax) shell script, suitable for evaluation within the shell environment of the caller. A one-line script is printed to \f(CW\*(C`stdout\*(C'\fR which then \&\*(L"sources\*(R" (and immediately removes) this temporary file. This is @@ -187,27 +191,30 @@ \&\f(CW\*(C`stdout\*(C'\fR, because not all shell implementations like to "\fBeval\fR\*(L" large multi-line scripts. Hence, use this for executing the \*(R"\f(CW\*(C`env\*(C'\fR" run-commands within the current shell. -.IP "\fB@l_prefix@/bin/openpkg rc\fR \fB\-q\fR|\fB\-\-query\fR \fIvariable\fR [\fIvariable\fR ...]" 4 +.ie n .IP "\fB\fB@l_prefix\fB@/bin/openpkg rc\fR \fB\-q\fR|\fB\-\-query\fR \fIvariable\fR [\fIvariable\fR ...]" 4 +.el .IP "\fB\f(CB@l_prefix\fB@/bin/openpkg rc\fR \fB\-q\fR|\fB\-\-query\fR \fIvariable\fR [\fIvariable\fR ...]" 4 .IX Item "@l_prefix@/bin/openpkg rc -q|--query variable [variable ...]" \&\fBConfiguration Variable Querying.\fR This queries the effective values (see \fBRUN-COMMAND \s-1CONFIGURATION\s0\fR section below) of one or more run-command configuration \fIvariable\fRs. Use this within a shell script to selectively query a particular variable. -.IP "\fB@l_prefix@/bin/openpkg rc\fR \fB\-c\fR|\fB\-\-config\fR" 4 +.ie n .IP "\fB\fB@l_prefix\fB@/bin/openpkg rc\fR \fB\-c\fR|\fB\-\-config\fR" 4 +.el .IP "\fB\f(CB@l_prefix\fB@/bin/openpkg rc\fR \fB\-c\fR|\fB\-\-config\fR" 4 .IX Item "@l_prefix@/bin/openpkg rc -c|--config" \&\fBConfiguration Variable Summary.\fR This displays on \f(CW\*(C`stdout\*(C'\fR a three-column table showing the name, default and effective values of all run-command configuration variables. If \f(CW\*(C`stdout\*(C'\fR is connected to terminal device, variables where the default and effective values differ are shown in bold mode. -.IP "\fB@l_prefix@/bin/openpkg rc\fR \fB\-h\fR|\fB\-\-help\fR" 4 +.ie n .IP "\fB\fB@l_prefix\fB@/bin/openpkg rc\fR \fB\-h\fR|\fB\-\-help\fR" 4 +.el .IP "\fB\f(CB@l_prefix\fB@/bin/openpkg rc\fR \fB\-h\fR|\fB\-\-help\fR" 4 .IX Item "@l_prefix@/bin/openpkg rc -h|--help" \&\fBRequesting Help.\fR This just displays a short summary of the usage for this program. .SH "FILES" .IX Header "FILES" -.ie n .Sh "RUN-COMMAND \s-1FILES\s0 (\*(C`@l_prefix@/bin/openpkg rc.d/rc.*\*(C')" -.el .Sh "RUN-COMMAND \s-1FILES\s0 (\f(CW\*(C`@l_prefix@/bin/openpkg rc.d/rc.*\*(C'\fP)" +.ie n .SS "RUN-COMMAND \s-1FILES\s0 (\*(C`@l_prefix@/bin/openpkg rc.d/rc.*\*(C')" +.el .SS "RUN-COMMAND \s-1FILES\s0 (\f(CW\*(C`@l_prefix@/bin/openpkg rc.d/rc.*\*(C'\fP)" .IX Subsection "RUN-COMMAND FILES (@l_prefix@/bin/openpkg rc.d/rc.*)" The foundation of the \fBOpenPKG\fR run-command facility are the individual run-command files \f(CW\*(C`rc.*\*(C'\fR of the installed packages. They are all @@ -267,23 +274,23 @@ is tagged with option \fB\-o\fR, \fIstdout\fR messages are passed through verbatim, even if the section script exists with a zero return value. .RS 4 -.ie n .IP "%start\fR [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority]" 4 +.ie n .IP "%start [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority\fR]" 4 .el .IP "\f(CW%start\fR [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority\fR]" 4 .IX Item "%start [-u user] [-p priority]" This section should start daemons or initialize components. It is especially executed by \fBOpenPKG\fR during system startup. -.ie n .IP "%stop\fR [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority]" 4 +.ie n .IP "%stop [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority\fR]" 4 .el .IP "\f(CW%stop\fR [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority\fR]" 4 .IX Item "%stop [-u user] [-p priority]" This section should stop daemons or cleaning up components. It is especially executed by \fBOpenPKG\fR during system shutdown and package deinstallation. -.ie n .IP "%restart\fR [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority]" 4 +.ie n .IP "%restart [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority\fR]" 4 .el .IP "\f(CW%restart\fR [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority\fR]" 4 .IX Item "%restart [-u user] [-p priority]" This section should restart daemons. It is especially executed by \fBOpenPKG\fR during package upgrades. -.ie n .IP "\*(C`%status \-o\*(C'\fR [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority]" 4 +.ie n .IP "\*(C`%status \-o\*(C' [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority\fR]" 4 .el .IP "\f(CW\*(C`%status \-o\*(C'\fR [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority\fR]" 4 .IX Item "%status -o [-u user] [-p priority]" This section has to provide status information for a package @@ -293,7 +300,7 @@ .ie n .IP "\fIpackage\fR\*(C`_enable\*(C'" 4 .el .IP "\fIpackage\fR\f(CW\*(C`_enable\*(C'\fR" 4 .IX Item "package_enable" -Whether package is enabled, i.e., whether it accepts run\-commands. This +Whether package is enabled, i.e., whether it accepts run-commands. This variable just has to be printed, because is already set in current script environment. .ie n .IP "\fIpackage\fR\*(C`_usable\*(C'" 4 @@ -309,17 +316,17 @@ .RE .RS 4 .RE -.ie n .IP "%monthly\fR [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority]" 4 +.ie n .IP "%monthly [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority\fR]" 4 .el .IP "\f(CW%monthly\fR [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority\fR]" 4 .IX Item "%monthly [-u user] [-p priority]" .PD 0 -.ie n .IP "%weekly\fR [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority]" 4 +.ie n .IP "%weekly [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority\fR]" 4 .el .IP "\f(CW%weekly\fR [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority\fR]" 4 .IX Item "%weekly [-u user] [-p priority]" -.ie n .IP "%hourly\fR [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority]" 4 +.ie n .IP "%hourly [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority\fR]" 4 .el .IP "\f(CW%hourly\fR [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority\fR]" 4 .IX Item "%hourly [-u user] [-p priority]" -.ie n .IP "%quarterly\fR [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority]" 4 +.ie n .IP "%quarterly [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority\fR]" 4 .el .IP "\f(CW%quarterly\fR [\fB\-u\fR \fIuser\fR] [\fB\-p\fR \fIpriority\fR]" 4 .IX Item "%quarterly [-u user] [-p priority]" .PD @@ -340,16 +347,16 @@ package. Some often seen sections are \f(CW%reload\fR (just reload the configuration without full stop and start procedure), \f(CW%info\fR (output arbitrary information about package), etc. -.ie n .Sh "RUN-COMMAND \s-1CONFIGURATION\s0 (\*(C`@l_prefix@/bin/openpkg rc.conf\*(C')" -.el .Sh "RUN-COMMAND \s-1CONFIGURATION\s0 (\f(CW\*(C`@l_prefix@/bin/openpkg rc.conf\*(C'\fP)" +.ie n .SS "RUN-COMMAND \s-1CONFIGURATION\s0 (\*(C`@l_prefix@/bin/openpkg rc.conf\*(C')" +.el .SS "RUN-COMMAND \s-1CONFIGURATION\s0 (\f(CW\*(C`@l_prefix@/bin/openpkg rc.conf\*(C'\fP)" .IX Subsection "RUN-COMMAND CONFIGURATION (@l_prefix@/bin/openpkg rc.conf)" The run-command configuration variables defined in the "\f(CW%config\fR" sections of all installed packages can be overridden by the administrator in the global file \f(CW\*(C`@l_prefix@/bin/openpkg rc.conf\*(C'\fR. This file is usually empty, but can be filled with Bourne-Shell compatible variable assignment statements like "\fIpackage\fR\f(CW\*(C`_\*(C'\fR\fIvariable\fR=\fIvalue\fR". -.ie n .Sh "RUN-COMMAND \s-1FUNCTIONS\s0 (\*(C`@l_prefix@/bin/openpkg rc.func\*(C')" -.el .Sh "RUN-COMMAND \s-1FUNCTIONS\s0 (\f(CW\*(C`@l_prefix@/bin/openpkg rc.func\*(C'\fP)" +.ie n .SS "RUN-COMMAND \s-1FUNCTIONS\s0 (\*(C`@l_prefix@/bin/openpkg rc.func\*(C')" +.el .SS "RUN-COMMAND \s-1FUNCTIONS\s0 (\f(CW\*(C`@l_prefix@/bin/openpkg rc.func\*(C'\fP)" .IX Subsection "RUN-COMMAND FUNCTIONS (@l_prefix@/bin/openpkg rc.func)" The file \f(CW\*(C`@l_prefix@/bin/openpkg rc.func\*(C'\fR is prepended to the scripts of all executed run-command sections and provides reusable functions. @@ -406,74 +413,60 @@ \& foo_log_numfiles="10" \& foo_log_minsize="1M" \& foo_log_complevel="9" -.Ve -.PP -.Vb 13 +\& \& %common \& foo_homedir="@l_prefix@/share/foo" \& foo_cfgfile="@l_prefix@/etc/foo/foo.cfg" \& foo_pidfile="@l_prefix@/var/foo/foo.pid" \& foo_logfile="@l_prefix@/var/foo/foo.log" \& foo_signal () { -\& if [ -f ${foo_pidfile} ]; then -\& kill -$1 `cat ${foo_pidfile}` +\& if [ \-f ${foo_pidfile} ]; then +\& kill \-$1 \`cat ${foo_pidfile}\` \& return $? \& else \& return 1 \& fi \& } -.Ve -.PP -.Vb 15 +\& \& %status \& foo_usable="no" -\& if [ ".`grep '<>' ${foo_cfgfile}`" = . ]; then +\& if [ ".\`grep \*(Aq<>\*(Aq ${foo_cfgfile}\`" = . ]; then \& foo_usable="yes" \& fi \& foo_active="no" -\& if [ -f ${foo_pidfile} ]; then +\& if [ \-f ${foo_pidfile} ]; then \& foo_signal 0 -\& if [ $? -eq 0 ]; then +\& if [ $? \-eq 0 ]; then \& foo_active="yes" \& fi \& fi \& echo "foo_enable=${foo_enable}" \& echo "foo_usable=${foo_usable}" \& echo "foo_active=${foo_active}" -.Ve -.PP -.Vb 4 +\& \& %start \& rcService foo enable yes || exit 0 \& rcService foo active yes && exit 0 -\& @l_prefix@/sbin/foo --listen ${foo_listen} -.Ve -.PP -.Vb 4 +\& @l_prefix@/sbin/foo \-\-listen ${foo_listen} +\& \& %stop \& rcService foo enable yes || exit 0 \& rcService foo active yes || exit 0 \& foo_signal TERM -.Ve -.PP -.Vb 4 +\& \& %restart \& rcService foo enable yes || exit 0 \& rcService foo active yes || exit 0 \& rc foo stop start -.Ve -.PP -.Vb 7 +\& \& %daily \& rcService foo enable yes || exit 0 -\& shtool rotate -f \e -\& -n ${foo_log_numfiles} -s ${foo_log_minsize} -d \e -\& -z ${foo_log_complevel} -o @l_rusr@ -g @l_rgrp@ -m 644 \e -\& -P "${foo_log_prolog}" -E "${foo_log_epilog}" \e +\& shtool rotate \-f \e +\& \-n ${foo_log_numfiles} \-s ${foo_log_minsize} \-d \e +\& \-z ${foo_log_complevel} \-o @l_rusr@ \-g @l_rgrp@ \-m 644 \e +\& \-P "${foo_log_prolog}" \-E "${foo_log_epilog}" \e \& ${foo_logfile} -.Ve -.PP -.Vb 5 +\& \& %env \& if rcService foo enable yes; then \& FOO_HOME="$foo_homedir" @@ -485,14 +478,14 @@ default values and their effective values of package "\f(CW\*(C`foo\*(C'\fR": .PP .Vb 1 -\& $ @l_prefix@/bin/openpkg rc --config | grep "^foo_" +\& $ @l_prefix@/bin/openpkg rc \-\-config | grep "^foo_" .Ve .PP Override the default value of a run-command configuration variable \f(CW\*(C`foo_listen\*(C'\fR: .PP .Vb 1 -\& $ echo 'foo_listen="192.168.0.1"' >>@l_prefix@/bin/openpkg rc.conf +\& $ echo \*(Aqfoo_listen="192.168.0.1"\*(Aq >>@l_prefix@/bin/openpkg rc.conf .Ve .PP Stop and start from scratch the package "\f(CW\*(C`foo\*(C'\fR": @@ -505,14 +498,14 @@ variable \f(CW\*(C`foo_enable\*(C'\fR in a script: .PP .Vb 1 -\& if [ ".`@l_prefix@/bin/openpkg rc -q foo_enable`" = .yes ]; then ... +\& if [ ".\`@l_prefix@/bin/openpkg rc \-q foo_enable\`" = .yes ]; then ... .Ve .PP Import all environment settings from all (including "\f(CW\*(C`foo\*(C'\fR") installed packages into the current Bourne-Shell environment: .PP .Vb 2 -\& $ eval `@l_prefix@/bin/openpkg rc --eval all env` +\& $ eval \`@l_prefix@/bin/openpkg rc \-\-eval all env\` \& $ echo $FOO_HOME .Ve .SH "SEE ALSO"