1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
|
.TH NETENV "8" "Jan 2004" "netenv-0.94.3"
.SH NAME
netenv \- Configure your system for different network environments
.SH SYNOPSIS
.B netenv
.SH DESCRIPTION
netenv is an interactive utility to switch between different network
configurations. It does not accept any command line arguments.
On Debian systems, netenv can work with both PCMCIA and on-board
network cards. You can also use netenv to configure your windowmanager
or your printing environment. The
.B new
menu item, however, will not work under many circumstances (it might
work with a PCMCIA card). The full documentation is included in html
format (see below).
Note that you either have to specify the boot parameter
.B NETENV=configname
or enter the chosen
environment by hand during boot time. The boot process will stop until you
entered something. Alternatively, you can specify a timeout, after
which the default configuration will be used (see below). If you want
to change to the default configuration without waiting for the
timeout, set \fBNETENV\fP to the hostname of your computer.
.P
Netenv needs the dialog binary for user interaction; if it cannot be
found, it will display an error message and exit.
The system administrator can also run
.B netenv
during normal operation.
.B netenv
will then ask wether to activate the changes by restarting the
networking now. In this case,
.B /etc/init.d/networking restart
will be executed as well as additional scripts specified in
.B NETENV_RUN_INIT_SCRIPTS
.SH CONFIGURATION
For setting up different network configurations and related
configuration files like XF86Config, see the html-Documentation.
.B netenv
will read the file
.B /etc/netenv/netenv.conf.
You can specify the following variables there:
.TP
.B ALLOW_EXPERT
If this is set to \fB YES\fP, you can enter \fI"expert mode"\fP by
pressing \fB CANCEL\fP in the chooser dialog. THIS IS A SECURITY RISK!
Everybody with physical access to your computer will get a\fB ROOT
SHELL\fP without any password! Do not leave your laptop alone when
this is set to YES. This feature is disabled by default.
.TP
.B COLS
The width of the screen used, in columns or characters. Default is 68.
.TP
.B NETENV_DO_RESTART
If set to \fByes\fP, and netenv is called with a controlling tty (that
is, interactively by root instead of by the init script), netenv
will restart the network without asking. If set to \fBnever\fP, it
will not do this, also without asking. Otherwise you will be asked,
obviously.
.TP
.B NETENV_TIMEOUT
The time (in seconds) netenv will show the dialog before chosing the
default configuration. The default is 0, which means that it will wait
forever.
.TP
.B NETENV_RUN_INIT_SCRIPTS
If the system administrator runs netenv during normal system
operation and chooses to activate the changes at once, then the init
scripts specified in this variable are called with argument
.B restart
after calling
.B /etc/init.d/networking restart.
You can use this to notify daemons
of the changed network configuration. The scripts have to reside in
.B /etc/init.d/
and must be specified as a space separated list, e.g.
.B NETENV_RUN_INIT_SCRIPTS="chrony myinitscript".
Default is none.
.TP
.B NETENV_START_STOP_SCRIPTS
In Debian, calling an init script with the argument
.B restart
means that it will execute itself twice, first with the argument stop,
then with start. Some init scripts, however, do more than
that. Currently I am only aware of wwwoffle, which checks its online
status before and switches back to the same state after restart. (The
netenv maintainer considers this a bug, the wwwoffle maintainer a
feature.) To be able to change from offline to online, or vice versa,
we have to work around this magic. This can be done by stopping the
service manually and starting it again, and that is what is done for
scripts in this variable (again a space separated list), e.g.
.B NETENV_START_STOP_SCRIPTS=wwwoffle
(for further information, see the html documentation).
.TP
.B NETENV_REMEMBER_LAST
Debian's netenv can also remember your last selection. You can enable this
by setting the variable to \fByes\fP. Furthemore if you set it to
\fBdefault\fP, your last selection will be used in case of timeout (see
\fBNETENV_TIMEOUT\fP).
.PP
Note that the default values are set in the script before
.B /etc/netenv/netenv.conf
is sourced. Thus, environment variables cannot be used (and this
doesn't make much sense since
.B netenv
usually is not called by a user.
Some other variables are also used and could, in principle, be defined
in
.B /etc/netenv/netenv.conf,
but aren't useful. See the executable
.B /sbin/netenv
for further information.
.SH "REPORTING BUGS"
Report bugs to Gerd Bavendiek <bav@epost.de>, or to the Debian
Bugtracking System if you're using this distribution.
.SH "SEE ALSO"
Further documentation for
.B netenv
can be found in
.B /usr/share/doc/netenv/netenv-en.html
and
.B /usr/share/doc/netenv/netenv-de.html
.SH AUTHOR
.B netenv
was written by Gerd Bavendiek <bav@epost.de> and adapted for Debian by
Michael Meskes <meskes@debian.org>, Robert van der Meulen
<rvdm@debian.org> and Frank K\[:u]ster <frank@kuesterei.ch>.
This manual page was written by Frank K\[:u]ster.
|
