Updated ipsec script man page after removing pluto
This commit is contained in:
+70
-84
@@ -31,161 +31,148 @@ and the IPsec version number.
|
|||||||
.PP
|
.PP
|
||||||
.SS CONTROL COMMANDS
|
.SS CONTROL COMMANDS
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec start [ starter options ]"
|
.B "start [ starter options ]"
|
||||||
calls
|
calls
|
||||||
.BR "ipsec starter"
|
.BR "starter"
|
||||||
which in turn parses \fIipsec.conf\fR and starts the IKEv1 \fIpluto\fR and
|
which in turn parses \fIipsec.conf\fR and starts the IKEv1/IKEv2 daemon
|
||||||
IKEv2 \fIcharon\fR daemons.
|
\fIcharon\fR.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec update"
|
.B "update"
|
||||||
sends a \fIHUP\fR signal to
|
sends a \fIHUP\fR signal to
|
||||||
.BR "ipsec starter"
|
.BR "starter"
|
||||||
which in turn determines any changes in \fIipsec.conf\fR
|
which in turn determines any changes in \fIipsec.conf\fR
|
||||||
and updates the configuration on the running IKEv1 \fIpluto\fR and IKEv2
|
and updates the configuration on the running IKE daemon \fIcharon\fR.
|
||||||
\fIcharon\fR daemons, correspondingly.
|
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec reload"
|
.B "reload"
|
||||||
sends a \fIUSR1\fR signal to
|
sends a \fIUSR1\fR signal to
|
||||||
.BR "ipsec starter"
|
.BR "starter"
|
||||||
which in turn reloads the whole configuration on the running IKEv1 \fIpluto\fR
|
which in turn reloads the whole configuration on the running IKE daemon
|
||||||
and IKEv2 \fIcharon\fR daemons based on the actual \fIipsec.conf\fR.
|
\fIcharon\fR based on the actual \fIipsec.conf\fR.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec restart"
|
.B "restart"
|
||||||
is equivalent to
|
is equivalent to
|
||||||
.B "ipsec stop"
|
.B "stop"
|
||||||
followed by
|
followed by
|
||||||
.B "ipsec start"
|
.B "start"
|
||||||
after a guard of 2 seconds.
|
after a guard of 2 seconds.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec stop"
|
.B "stop"
|
||||||
terminates all IPsec connections and stops the IKEv1 \fIpluto\fR and IKEv2
|
terminates all IPsec connections and stops the IKE daemon \fIcharon\fR
|
||||||
\fIcharon\fR daemons by sending a \fITERM\fR signal to
|
by sending a \fITERM\fR signal to
|
||||||
.BR "ipsec starter".
|
.BR "starter".
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec up \fIname\fP"
|
.B "up \fIname\fP"
|
||||||
tells the responsible IKE daemon to start up connection \fIname\fP.
|
tells the IKE daemon to start up connection \fIname\fP.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec down \fIname\fP"
|
.B "down \fIname\fP"
|
||||||
tells the responsible IKE daemon to terminate connection \fIname\fP.
|
tells the IKE daemon to terminate connection \fIname\fP.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec down \fIname{n}\fP"
|
.B "down \fIname{n}\fP"
|
||||||
terminates IKEv2 CHILD SA instance \fIn\fP of connection \fIname\fP.
|
terminates IKEv1 Quick Mode and IKEv2 CHILD SA instance \fIn\fP of
|
||||||
|
connection \fIname\fP.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec down \fIname{*}\fP"
|
.B "down \fIname{*}\fP"
|
||||||
terminates all IKEv2 CHILD SA instances of connection \fIname\fP.
|
terminates all IKEv1 Quick Mode and IKEv2 CHILD SA instances of connection
|
||||||
|
\fIname\fP.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec down \fIname[n]\fP"
|
.B "down \fIname[n]\fP"
|
||||||
terminates all IKEv2 IKE SA instance \fIn\fP of connection \fIname\fP.
|
terminates IKE SA instance \fIn\fP of connection \fIname\fP.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec down \fIname[*]\fP"
|
.B "down \fIname[*]\fP"
|
||||||
terminates all IKEv2 IKE SA instances of connection \fIname\fP.
|
terminates all IKE SA instances of connection \fIname\fP.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec route \fIname\fP"
|
.B "route \fIname\fP"
|
||||||
tells the responsible IKE daemon to insert an IPsec policy in the kernel
|
tells the IKE daemon to insert an IPsec policy in the kernel
|
||||||
for connection \fIname\fP. The first payload packet matching the IPsec policy
|
for connection \fIname\fP. The first payload packet matching the IPsec policy
|
||||||
will automatically trigger an IKE connection setup.
|
will automatically trigger an IKE connection setup.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec unroute \fIname\fP"
|
.B "unroute \fIname\fP"
|
||||||
remove the IPsec policy in the kernel for connection \fIname\fP.
|
remove the IPsec policy in the kernel for connection \fIname\fP.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec status [ \fIname\fP ]"
|
.B "status [ \fIname\fP ]"
|
||||||
returns concise status information either on connection
|
returns concise status information either on connection
|
||||||
\fIname\fP or if the argument is lacking, on all connections.
|
\fIname\fP or if the argument is lacking, on all connections.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec statusall [ \fIname\fP ]"
|
.B "statusall [ \fIname\fP ]"
|
||||||
returns detailed status information either on connection
|
returns detailed status information either on connection
|
||||||
\fIname\fP or if the argument is lacking, on all connections.
|
\fIname\fP or if the argument is lacking, on all connections.
|
||||||
.PP
|
.PP
|
||||||
.SS LIST COMMANDS
|
.SS LIST COMMANDS
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec listalgs"
|
.B "listalgs"
|
||||||
returns a list all supported IKE encryption and hash algorithms, the available
|
returns a list supported cryptographic algorithms usable for IKE, and their
|
||||||
Diffie-Hellman groups, as well as all supported ESP encryption and
|
corresponding plugin.
|
||||||
authentication algorithms registered via the Linux kernel's Crypto API.
|
|
||||||
.br
|
|
||||||
Supported by the IKEv1 \fIpluto\fP daemon only.
|
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec listpubkeys [ --utc ]"
|
.B "listpubkeys [ --utc ]"
|
||||||
returns a list of RSA public keys that were either loaded in raw key format
|
returns a list of RSA public keys that were either loaded in raw key format
|
||||||
or extracted from X.509 and|or OpenPGP certificates.
|
or extracted from X.509 and|or OpenPGP certificates.
|
||||||
.br
|
|
||||||
Supported by the IKEv1 \fIpluto\fP daemon only.
|
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec listcerts [ --utc ]"
|
.B "listcerts [ --utc ]"
|
||||||
returns a list of X.509 and|or OpenPGP certificates that were either loaded
|
returns a list of X.509 and|or OpenPGP certificates that were either loaded
|
||||||
locally by the IKE daemon or received via the IKEv2 protocol.
|
locally by the IKE daemon or received via the IKE protocol.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec listcacerts [ --utc ]"
|
.B "listcacerts [ --utc ]"
|
||||||
returns a list of X.509 Certification Authority (CA) certificates that were
|
returns a list of X.509 Certification Authority (CA) certificates that were
|
||||||
loaded locally by the IKE daemon from the \fI/etc/ipsec.d/cacerts/\fP
|
loaded locally by the IKE daemon from the \fI/etc/ipsec.d/cacerts/\fP
|
||||||
directory or received in PKCS#7-wrapped certificate payloads via the IKE
|
directory or received via the IKE protocol.
|
||||||
protocol.
|
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec listaacerts [ --utc ]"
|
.B "listaacerts [ --utc ]"
|
||||||
returns a list of X.509 Authorization Authority (AA) certificates that were
|
returns a list of X.509 Authorization Authority (AA) certificates that were
|
||||||
loaded locally by the IKE daemon from the \fI/etc/ipsec.d/aacerts/\fP
|
loaded locally by the IKE daemon from the \fI/etc/ipsec.d/aacerts/\fP
|
||||||
directory.
|
directory.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec listocspcerts [ --utc ]"
|
.B "listocspcerts [ --utc ]"
|
||||||
returns a list of X.509 OCSP Signer certificates that were either loaded
|
returns a list of X.509 OCSP Signer certificates that were either loaded
|
||||||
locally by the IKE daemon from the \fI/etc/ipsec.d/ocspcerts/\fP
|
locally by the IKE daemon from the \fI/etc/ipsec.d/ocspcerts/\fP
|
||||||
directory or were sent by an OCSP server.
|
directory or were sent by an OCSP server.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec listacerts [ --utc ]"
|
.B "listacerts [ --utc ]"
|
||||||
returns a list of X.509 Attribute certificates that were loaded locally by
|
returns a list of X.509 Attribute certificates that were loaded locally by
|
||||||
the IKE daemon from the \fI/etc/ipsec.d/acerts/\fP directory.
|
the IKE daemon from the \fI/etc/ipsec.d/acerts/\fP directory.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec listgroups [ --utc ]"
|
.B "listgroups [ --utc ]"
|
||||||
returns a list of groups that are used to define user authorization profiles.
|
returns a list of groups that are used to define user authorization profiles.
|
||||||
.br
|
|
||||||
Supported by the IKEv1 \fIpluto\fP daemon only.
|
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec listcainfos [ --utc ]"
|
.B "listcainfos [ --utc ]"
|
||||||
returns certification authority information (CRL distribution points, OCSP URIs,
|
returns certification authority information (CRL distribution points, OCSP URIs,
|
||||||
LDAP servers) that were defined by
|
LDAP servers) that were defined by
|
||||||
.BR ca
|
.BR ca
|
||||||
sections in \fIipsec.conf\fP.
|
sections in \fIipsec.conf\fP.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec listcrls [ --utc ]"
|
.B "listcrls [ --utc ]"
|
||||||
returns a list of Certificate Revocation Lists (CRLs) that were either loaded
|
returns a list of Certificate Revocation Lists (CRLs) that were either loaded
|
||||||
by the IKE daemon from the \fI/etc/ipsec.d/crls\fP directory or fetched from
|
by the IKE daemon from the \fI/etc/ipsec.d/crls\fP directory or fetched from
|
||||||
an HTTP- or LDAP-based CRL distribution point.
|
an HTTP- or LDAP-based CRL distribution point.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec listocsp [ --utc ]"
|
.B "listocsp [ --utc ]"
|
||||||
returns revocation information fetched from OCSP servers.
|
returns revocation information fetched from OCSP servers.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec listcards [ --utc ]"
|
.B "listall [ --utc ]"
|
||||||
list all certificates found on attached smart cards.
|
|
||||||
.br
|
|
||||||
Supported by the IKEv1 \fIpluto\fP daemon only.
|
|
||||||
.PP
|
|
||||||
.TP
|
|
||||||
.B "ipsec listall [ --utc ]"
|
|
||||||
returns all information generated by the list commands above. Each list command
|
returns all information generated by the list commands above. Each list command
|
||||||
can be called with the
|
can be called with the
|
||||||
\fB\-\-utc\fP
|
\fB\-\-utc\fP
|
||||||
@@ -193,78 +180,78 @@ option which displays all dates in UTC instead of local time.
|
|||||||
.PP
|
.PP
|
||||||
.SS REREAD COMMANDS
|
.SS REREAD COMMANDS
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec rereadsecrets"
|
.B "rereadsecrets"
|
||||||
flushes and rereads all secrets defined in \fIipsec.secrets\fP.
|
flushes and rereads all secrets defined in \fIipsec.secrets\fP.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec rereadcacerts"
|
.B "rereadcacerts"
|
||||||
reads all certificate files contained in the \fI/etc/ipsec.d/cacerts\fP
|
reads all certificate files contained in the \fI/etc/ipsec.d/cacerts\fP
|
||||||
directory and adds them to the list of Certification Authority (CA)
|
directory and adds them to the list of Certification Authority (CA)
|
||||||
certificates.
|
certificates.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec rereadaacerts"
|
.B "rereadaacerts"
|
||||||
reads all certificate files contained in the \fI/etc/ipsec.d/aacerts\fP
|
reads all certificate files contained in the \fI/etc/ipsec.d/aacerts\fP
|
||||||
directory and adds them to the list of Authorization Authority (AA)
|
directory and adds them to the list of Authorization Authority (AA)
|
||||||
certificates.
|
certificates.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec rereadocspcerts"
|
.B "rereadocspcerts"
|
||||||
reads all certificate files contained in the \fI/etc/ipsec.d/ocspcerts/\fP
|
reads all certificate files contained in the \fI/etc/ipsec.d/ocspcerts/\fP
|
||||||
directory and adds them to the list of OCSP signer certificates.
|
directory and adds them to the list of OCSP signer certificates.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec rereadacerts"
|
.B "rereadacerts"
|
||||||
reads all certificate files contained in the \fI/etc/ipsec.d/acerts/\fP
|
reads all certificate files contained in the \fI/etc/ipsec.d/acerts/\fP
|
||||||
directory and adds them to the list of attribute certificates.
|
directory and adds them to the list of attribute certificates.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec rereadcrls"
|
.B "rereadcrls"
|
||||||
reads all Certificate Revocation Lists (CRLs) contained in the
|
reads all Certificate Revocation Lists (CRLs) contained in the
|
||||||
\fI/etc/ipsec.d/crls/\fP directory and adds them to the list of CRLs.
|
\fI/etc/ipsec.d/crls/\fP directory and adds them to the list of CRLs.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec rereadall"
|
.B "rereadall"
|
||||||
executes all reread commands listed above.
|
executes all reread commands listed above.
|
||||||
.PP
|
.PP
|
||||||
.SS PURGE COMMANDS
|
.SS PURGE COMMANDS
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec purgeike"
|
.B "purgeike"
|
||||||
purges IKEv2 SAs that don't have a CHILD SA.
|
purges IKE SAs that don't have a Quick Mode or CHILD SA.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec purgeocsp"
|
.B "purgeocsp"
|
||||||
purges all cached OCSP information records.
|
purges all cached OCSP information records.
|
||||||
.PP
|
.PP
|
||||||
.SS INFO COMMANDS
|
.SS INFO COMMANDS
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec \-\-help"
|
.B "\-\-help"
|
||||||
returns the usage information for the ipsec command.
|
returns the usage information for the ipsec command.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec \-\-version"
|
.B "\-\-version"
|
||||||
returns the version in the form of
|
returns the version in the form of
|
||||||
.B Linux strongSwan U<strongSwan userland version>/K<Linux kernel version>
|
.B Linux strongSwan U<strongSwan userland version>/K<Linux kernel version>
|
||||||
if strongSwan uses the native NETKEY IPsec stack of the Linux kernel it is
|
if strongSwan uses the native NETKEY IPsec stack of the Linux kernel it is
|
||||||
running on.
|
running on.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec \-\-versioncode"
|
.B "\-\-versioncode"
|
||||||
returns the version number in the form of
|
returns the version number in the form of
|
||||||
.B U<strongSwan userland version>/K<Linux kernel version>
|
.B U<strongSwan userland version>/K<Linux kernel version>
|
||||||
if strongSwan uses the native NETKEY IPsec stack of the Linux kernel it is
|
if strongSwan uses the native NETKEY IPsec stack of the Linux kernel it is
|
||||||
running on.
|
running on.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec \-\-copyright"
|
.B "\-\-copyright"
|
||||||
returns the copyright information.
|
returns the copyright information.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec \-\-directory"
|
.B "\-\-directory"
|
||||||
returns the \fILIBEXECDIR\fP directory as defined by the configure options.
|
returns the \fILIBEXECDIR\fP directory as defined by the configure options.
|
||||||
.PP
|
.PP
|
||||||
.TP
|
.TP
|
||||||
.B "ipsec \-\-confdir"
|
.B "\-\-confdir"
|
||||||
returns the \fISYSCONFDIR\fP directory as defined by the configure options.
|
returns the \fISYSCONFDIR\fP directory as defined by the configure options.
|
||||||
.SH FILES
|
.SH FILES
|
||||||
/usr/local/lib/ipsec usual utilities directory
|
/usr/local/lib/ipsec usual utilities directory
|
||||||
@@ -285,8 +272,7 @@ IPSEC_PIDDIR directory containing PID files
|
|||||||
IPSEC_NAME name of ipsec distribution
|
IPSEC_NAME name of ipsec distribution
|
||||||
IPSEC_VERSION version numer of ipsec userland and kernel
|
IPSEC_VERSION version numer of ipsec userland and kernel
|
||||||
IPSEC_STARTER_PID PID file for ipsec starter
|
IPSEC_STARTER_PID PID file for ipsec starter
|
||||||
IPSEC_PLUTO_PID PID file for IKEv1 keying daemon
|
IPSEC_CHARON_PID PID file for IKE keying daemon
|
||||||
IPSEC_CHARON_PID PID file for IKEv2 keying daemon
|
|
||||||
.ad
|
.ad
|
||||||
.fi
|
.fi
|
||||||
.SH SEE ALSO
|
.SH SEE ALSO
|
||||||
|
|||||||
Reference in New Issue
Block a user