← Back to branch summary

~ubuntu-branches/ubuntu/hardy/openswan/hardy-updates

« back to all changes in this revision

Viewing changes to programs/starter/starter.8

  • Committer: Bazaar Package Importer
  • Author(s): Rene Mayrhofer
  • Date: 2005-01-27 16:10:11 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20050127161011-idgybmyz3vwhpfiq
Tags: 2.3.0-2
http://bugs.debian.org/292458
http://bugs.debian.org/291143
Urgency HIGH due to security issue and problems with build-deps in sarge.
* Fix the security issue. Please see
  http://www.idefense.com/application/poi/display?id=190&
      type=vulnerabilities&flashstatus=false
  for more details. Thanks to Martin Schulze for informing me about
  this issue.
  Closes: #292458: Openswan XAUTH/PAM Buffer Overflow Vulnerability
* Added a Build-Dependency to lynx.
  Closes: #291143: openswan: FTBFS: Missing build dependency.

Show diffs side-by-side

added added

removed removed

Lines of Context:
programs/starter/starter.8
 
1
.TH IPSEC_STARTER 8 "29 Nov 2004"
 
2
.\"
 
3
.\" RCSID $Id: starter.8,v 1.4 2004/12/07 00:28:08 ken Exp $
 
4
.\"
 
5
.SH NAME
 
6
ipsec starter \- start up the IPsec keying daemon (pluto) and load
 
7
configuration
 
8
.SH SYNOPSIS
 
9
.ad l
 
10
.hy 0
 
11
.HP 10
 
12
ipsec starter [\fB\-\-debug \-\-auto_reload seconds \-\-parsedebug \-\-verbose \-\-dumpcfg\fR]
 
13
.ad
 
14
.hy
 
15
.SH "DESCRIPTION"
 
16
.PP
 
17
Openswan Starter is aimed to replace all the scripts which are used to
 
18
start and stop Openswan, and to do that in a quicker and a smarter way.
 
19
.PP
 
20
It can also reload the configuration file if given a \fRHUP\fB signal, 
 
21
and apply the changes.
 
22
.PP
 
23
What it will do:
 
24
.PP
 
25
Load and unload KLIPS, or NETKEY (ipsec kernel module)
 
26
.PP
 
27
Launch and monitor pluto.
 
28
.PP
 
29
Add, initiate, route and delete connections
 
30
.PP
 
31
Attach and detach interfaces according to config file
 
32
.PP
 
33
kill -HUP can be used to reload the config file. New connections will be
 
34
added, old ones will be removed and modified ones will be reloaded.
 
35
Interfaces/Klips/Pluto will be reloaded if necessary.
 
36
.PP
 
37
Upon startup, starter will save its pid to the file /var/run/ipsec-starter.pid
 
38
.PP
 
39
Upon reloading, dynamic DNS addresses will be resolved and updated. 
 
40
Use \-\-auto_reload to periodicaly check for dynamic DNS changes.
 
41
.PP
 
42
kill \-USR1 can be used to reload all connections.  This does a \fBdelete\fR, 
 
43
followed by an \fBadd\fR and then either a \fBroute\fR or \fBinitiate\fR operation.
 
44
.PP
 
45
/var/run/dynip/xxxx can be used to use a virtual interface name in
 
46
ipsec.conf. By example, when adsl can be ppp0, ppp1, or some such, one
 
47
can do:
 
48
.PP
 
49
.B ipsec.conf:             interfaces="ipsec0=adsl"
 
50
And use /etc/ppp/ip-up to create /var/run/dynip/adsl
 
51
    /var/run/dynip/adsl:    IP_PHYS=ppp0
 
52
.PP
 
53
%auto can be used to automaticaly name the connections
 
54
.PP
 
55
kill \-TERM can be used to stop Openswan. Pluto will be stopped and 
 
56
kernel modules unloaded.
 
57
.PP 
 
58
.SH FILES
 
59
/etc/ipsec.conf
 
60
.SH "SEE ALSO"
 
61
ipsec(8), ipsec_tncfg(8), ipsec_pluto(8)
 
62
.SH HISTORY
 
63
Original by mlafon@arkoon.net for Arkoon Network Security. Updated for
 
64
FreeS/WAN version 2 by Michael Richardson <mcr@sandelman.ottawa.on.ca>.
 
65
Merged into Openswan 2.2 by Xelerance Corporation
 
66
.SH TODO/BUGS
 
67
.PP
 
68
handle wildcards in include lines \-\- use glob() fct ex: include /etc/ipsec.*.conf
 
69
.PP 
 
70
handle duplicates keywords and sections
 
71
.PP 
 
72
Support also keyword
 
73
.PP 
 
74
add unsupported keywords
 
75
.PP 
 
76
manually keyed connections
 
77
.PP 
 
78
%defaultroute
 
79
.PP 
 
80
IPv6
 
81
.PP