.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" 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.  \*(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-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'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 >0, we'll generate index entries on stderr for
.\" 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.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "RCCONF 8"
.TH RCCONF 8 "2018-11-11" "perl v5.28.0" "Debian GNU/Linux"
.\" 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"
rcconf \- Debian Runlevel configuration tool
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBrcconf\fR [options]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBRcconf\fR allows you to control which services are started when the
system boots up or reboots.  It displays a menu of all the services 
which could be started at boot.  The ones that are configured to
do so are marked and you can toggle individual services on and off.
.PP
\&\fBRcconf\fR gets a list of services from /etc/init.d and looks in the
/etc/rc?.d directories to determine whether each service is on or off.
\&\fBRcconf\fR detects \s-1ON\s0 state by existence of /etc/rc?.d/\*(L"S\*(R"NNname.
.PP
If the number(\s-1NN\s0 of /etc/rc?.d/[\s-1SK\s0]NNname) is not 20(default), \fBrcconf\fR
saves the service name and the number in /var/lib/rcconf/services so
as to be able to restore the service to its original configuration.
.PP
If you purge \fBrcconf\fR package by 'dpkg \-\-purge' or 'aptitude purge' or
others, you may lose off state package due to deletion of
/var/lib/rcconf/services.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-\-help\fR" 3
.IX Item "--help"
.RS 3
.RS 2
Print out a usage message.
.RE
.RE
.RS 3
.RE
.IP "\fB\-\-dialog\fR" 3
.IX Item "--dialog"
.RS 3
.RS 2
Use dialog command to display menu
.RE
.RE
.RS 3
.RE
.IP "\fB\-\-whiptail\fR" 3
.IX Item "--whiptail"
.RS 3
.RS 2
Use whiptail command to display menu
.RE
.RE
.RS 3
.RE
.IP "\fB\-\-notermcheck\fR" 3
.IX Item "--notermcheck"
.RS 3
.RS 2
Do not set window size by terminal property.
.RE
.RE
.RS 3
.RE
.IP "\fB\-\-on\fR service[,service,...]" 3
.IX Item "--on service[,service,...]"
.RS 3
.RS 2
Set services to be on.
This option enables rcconf in command line mode and no select menu
will be displayed.
.RE
.RE
.RS 3
.RE
.IP "\fB\-\-off\fR service[,service,...]" 3
.IX Item "--off service[,service,...]"
.RS 3
.RS 2
Set services to be off.
This option enables rcconf in command line mode and no select menu
will be displayed.
.RE
.RE
.RS 3
.RE
.IP "\fB\-\-list\fR" 3
.IX Item "--list"
.RS 3
.RS 2
List services which includes current status(on/off).
This option enables rcconf in command line mode and no select menu
will be displayed. Use \fB\-\-expert\fR option together if you want to
list all services.
This result can be used as \fIconfig_file\fR of \fB\-\-config\fR.
.RE
.RE
.RS 3
.RE
.IP "\fB\-\-config\fR \fIconfig_file\fR" 3
.IX Item "--config config_file"
.RS 3
.RS 2
Set services on/off according to \fIconfig_file\fR.
This option enables rcconf in command line mode and no select menu
will be displayed. The format of this config file is 
\&\*(L"service_name on\*(R" or \*(L"service_name off\*(R" in each line. Refer to the
result of \fB\-\-list\fR.
.RE
.RE
.RS 3
.RE
.IP "\fB\-\-expert\fR" 3
.IX Item "--expert"
.RS 3
.RS 2
Show and select all services for experts. In default, rcconf doesn't
display system default services as a candidate such as mountall.sh to
hide unnecessary services for users(but very important for system).
.Sp
The list of which services are considered expert can be
found at the line \f(CW@expertonly\fR in /usr/sbin/rcconf.
.RE
.RE
.RS 3
.RE
.IP "\fB\-\-now\fR" 3
.IX Item "--now"
.RS 3
.RS 2
For each service that had the links changed, call the corresponding
/etc/init.d/service\-name script using invoke\-rc.d, so the package
starts or stops immediately. If you do not use this option, the 
changes will only take effect the next time you reboot (or change
runlevel).
.RE
.RE
.RS 3
.RE
.IP "\fB\-\-verbose\fR" 3
.IX Item "--verbose"
.RS 3
.RS 2
Output verbose messages.
.RE
.RE
.RS 3
.RE
.SH "Guide File"
.IX Header "Guide File"
\&\fBRcconf\fR can display some description(Guide) for each services
with Guide File.
Guide File is placed on /var/lib/rcconf/guide, and 
this Guide File does not exist by default. 
If you want to use Guide, you need to define guides for each services
in this file.
.PP
If you run \fBupdate-rcconf-guide\fR before \fBrcconf\fR,
\&\fBrcconf\fR can use default guides derived from package description.
\&\fBUpdate-rcconf-guide\fR generates the file '/var/lib/rcconf/guide.default' from
package description(only uses first line of it) using apt-cache.
\&\fBRcconf\fR refers Guides in /var/lib/rcconf/guide before
/var/lib/rcconf/guide.default.
.PP
If you install some packages after executed \fBupdate-rcconf-guide\fR,
you need to re-create this file using
\&\fBupdate-rcconf-guide\fR so as to refresh guide.default that includes new
guides for installed new services.
.SH "Updating /etc/rd?.c/ by the package(KNOWN PROBLEM)"
.IX Header "Updating /etc/rd?.c/ by the package(KNOWN PROBLEM)"
\&\fBRcconf\fR saves /etc/rc?.d/[\s-1SK\s0]NNname conditions into /var/lib/rcconf/services.
This file is updated only when there exists /etc/rc?.d/SNNname. It means that
the condition is not saved if /etc/rc?.d/SNNname doesn't exist for the package.
.PP
If the old version of the package creates both /etc/rc?.d/SNNname and
/etc/rc?.d/KNNname but the newer(updated) version of the package creates only
/etc/rc?.d/KNNname, some stupid condition occurs. That is, \fBrcconf\fR displays
this package as \s-1OFF\s0 state even as the updated package doesn't have
/etc/rc?.d/SNNname. That is because \fBrcconf\fR can't detect disappearance of
/etc/rc?.d/SNNname and previous /etc/rc?.d/SNNname condition remains in
/var/lib/rcconf/services for restore.
.PP
In that situation, remove the entry(corresponding package line) from
/var/lib/rcconf/services.
.SH "FILE"
.IX Header "FILE"
.IP "/var/lib/rcconf/services" 8
.IX Item "/var/lib/rcconf/services"
The service number data file.
.IP "/var/lib/rcconf/lock" 8
.IX Item "/var/lib/rcconf/lock"
Lock file.
.IP "/var/lib/rcconf/guide.default" 8
.IX Item "/var/lib/rcconf/guide.default"
Guide File update-rcconf-guide generates.
.IP "/var/lib/rcconf/guide" 8
.IX Item "/var/lib/rcconf/guide"
Guide File user(Administrator) can define.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBupdate\-rc.d\fR\|(8)
.PP
\&\fBupdate\-rcconf\-guide\fR\|(8)
.SH "AUTHOR"
.IX Header "AUTHOR"
Atsushi \s-1KAMOSHIDA\s0 <kamop@debian.org>