Manpage of IPSEC_SETUP
Section: Maintenance Commands (8)
Updated: 23 July 2001
Return to Main Contents
ipsec setup - control IPsec subsystem
controls the FreeS/WAN IPsec subsystem,
including both the Klips kernel code and the Pluto key-negotiation daemon.
(It is a synonym for the ``rc'' script for the subsystem;
the system runs the equivalent of
ipsec setup start
at boot time,
ipsec setup stop
at shutdown time, more or less.)
The action taken depends on the specific
and on the contents of the
section of the
IPsec configuration file (/etc/ipsec.conf,
start Klips and Pluto,
including setting up Klips to do crypto operations on the
interface(s) specified in the configuration file,
and (if the configuration file so specifies)
setting up manually-keyed connections and/or
asking Pluto to negotiate automatically-keyed connections
to other security gateways
shut down Klips and Pluto,
including tearing down all existing crypto connections
report the status of the subsystem;
normally just reports
pluto pid nnn,
and exits with status 0,
but will go into more detail (and exit with status 1)
if something strange is found.
(An ``illicit'' Pluto is one that does not match the process ID in
Pluto's lock file;
an ``orphaned'' Pluto is one with no lock file.)
operation tries to clean up properly even if assorted accidents
e.g. Pluto having died without removing its lock file.
discovers that the subsystem is (supposedly) not running,
it will complain,
but will do its cleanup anyway before exiting with status 1.
Although a number of configuration-file parameters influence
operations, the key one is the
parameter, which must be right or chaos will ensue.
to display the shell commands that it would execute.
suppresses their execution.
commands recognize these flags.
/etc/rc.d/init.d/ipsec the script itself
/etc/init.d/ipsec alternate location for the script
/etc/ipsec.conf IPsec configuration file
/proc/sys/net/ipv4/ip_forward forwarding control
/var/run/ipsec.info saved information
/var/run/pluto.pid Pluto lock file
/var/run/ipsec_setup.pid IPsec lock file
ipsec.conf(5), ipsec(8), ipsec_manual(8), ipsec_auto(8), route(8)
All output from the commands
goes both to standard
output and to
Selected additional information is logged only to
Written for the FreeS/WAN project
by Henry Spencer.
Old versions of
inject spurious extra newlines onto standard output.
- SEE ALSO
This document was created by
using the manual pages.
Time: 21:40:18 GMT, November 11, 2003