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
|
.TH LIGHTYENABLEMOD 1 2006-01-11
.SH NAME
lighty-enable-mod, lighty-disable-mod \- enable or disable configuration in lighttpd server
.SH SYNOPSIS
lighty-enable-mod [module]
.br
lighty-disable-mod [module]
.SH DESCRIPTION
This manual page documents briefly the lighty-enable-mod and
lighty-disable-mod commands.
lighty-enable-mod and lighty-disable-mod are programs that enable
(and respectively disable) the specified configuration file within
lighttpd configuration.
Both programs can be run interactively or from command
line. If either program is called without any arguments, an input
prompt is displayed to the user, where he might choose among available
.I "lighttpd"
modules. Immediate action is taken, if a module name was given on the
command line.
.SS EXIT STATUS
Both programs indicate failure in their exit status. lighty-enable-mod or
lighty-disable-mod respectively may leave execution with one of the following
exit codes:
.br
.TP 5
.B "0"
denotes success
.TP 5
.B "1"
denotes a fatal error (e.g., a module could not be enabled, or a dependency was not found)
.TP 5
.B "2"
denotes a minor flaw (e.g., a module was not enabled because it was already loaded before)
.TP 0
.B Note
You can (un-) load several modules at time. The exit status will only reflect the most serious issue (where a minor flaw beats no error, but a fatal error beats a minor flaw). This means, if a minor flaw was encountered as well as a fatal error, the program will leave with exit status 1 and stop immediately.
.SH DEPENDENCIES
Debian allows
.I "lighttpd"
modules to formulate dependencies to other modules they depend on. Configuration
files are scanned for dependencies upon load or
unload of modules, not at runtime of the web server. Such a magic line has the following format:
.nf
# -*- depends: module[, module] -*-
.fi
and may appear anywhere in the file. If such a line is found, the extracted name
is interpreted as dependency to another
.I "lighttpd"
module. lighty-enable-mod will seek available configurations to satisfy this
dependency and will recursively enable all dependencies found on its way.
lighty-disable-mod will disable reverse dependencies recursively.
.SH SEE ALSO
lighttpd(1)
.SH AUTHOR
Program and man pages were originally written by Krzysztof Krzyżaniak
<eloy@debian.org> and later modified by Arno Töll <debian@toell.net>
|
