rc.eselect

Section: eselect (5)
Updated: June 2009
Page Index

NAME

rc.eselect - Runlevel configuration module

SYNOPSIS

eselect rc [help|usage|version]
eselect rc add script [runlevel...]
eselect rc delete script [runlevel...]
eselect rc list [runlevel]
eselect rc pause script [script...]
eselect rc restart script [script...]
eselect rc show [runlevel...]
eselect rc start script [script...]
eselect rc stop script [script...]

DESCRIPTION

eselect is Gentoo's configuration and management tool. It features modules that care for the individual administrative tasks.

ACTION: ADD

eselect rc add script [runlevel...]
Add script to given runlevels. If no runlevel is given, this action will add script to the default runlevel.

# eselect rc add local default nonetwork notexisting
Adding local to following runlevels
  default                   [done]
  nonetwork                 [skipped]
  notexisting               [invalid]

The result-tags are as following

[done]: script successfully added to runlevel.
[failed]: script could not be added to runlevel.
[skipped]: script already part of runlevel.
[invalid]: runlevel is not existing.

ACTION: DELETE

eselect rc delete script [runlevel...]
Delete script from given runlevels. If no runlevel is given, this action will delete script from the default runlevel.

# eselect rc delete local nonetwork notexisting
Deleting local from following runlevels
nonetwork [done]
notexisting [invalid]

The result-tags are as following

[done]: script successfully deleted from runlevel
[failed]: script could not be deleted from runlevel.
[skipped]: script not part of runlevel.
[invalid]: runlevel is not existing.

ACTION: LIST

eselect rc list [runlevel]
Display an ordered list of init scripts that belong to runlevel. In case that no runlevel is given, this action will list all scripts from /etc/init.d/.

# eselect rc list default
Init scripts to be started by runlevel default
  cupsd
  local
  metalog
  net.eth0
  netmount
  powernowd
  sshd
  vixie-cron
  xdm
  xfs

ACTION: PAUSE

eselect rc pause script [script...]
Pause the given set of init scripts.

# eselect rc pause net.eth0

* Stopping eth0
* Bringing down eth0
* Shutting down eth0 ...

ACTION: RESTART

eselect rc restart script [script...]
Restart the given set of init scripts.

# eselect rc restart sshd
Restarting init script
* ERROR: "local" has not yet been started.
* Stopping sshd ... [ ok ]

ACTION: SHOW

eselect rc show [runlevel...]
Show init scripts that belong to runlevel and list them together with their status. If no runlevel is given, list the scripts from the current runlevel. With options --all or --unused the scripts of all runlevels or the scripts not assigned to any runlevel are shown, respectively.

# eselect rc show
Status of init scripts in runlevel "default"
  cupsd                     [started]
  local                     [started]
  metalog                   [started]
  net.eth0                  [started]
  netmount                  [started]
  powernowd                 [started]
  sshd                      [stopped]
  vixie-cron                [started]
  xdm                       [started]

The status flags are as following

[started]: script has been successfully run.
[stopped]: script has manually been stopped.
[starting]: script is starting.
[stopping]: script stop has been ordered, but it has not ceased yet.
[inactive]: script has started, but is inactive.
[unknown]: script is part of runlevel, but its status is not known.

ACTION: START

eselect rc start script [script...]
Starts the given set of init scripts manually, regardless of the current runlevel.

# eselect rc start local sshd
Restarting init script
* Starting local ... [ ok ]
* WARNING: "sshd" has already been started.

ACTION: STOP

eselect rc restart script [script...]
Restarts the given set of init scripts.