101 lines
2.9 KiB
Groff
101 lines
2.9 KiB
Groff
.\" Hey, EMACS: -*- nroff -*-
|
|
.\" First parameter, NAME, should be all caps
|
|
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
|
.\" other parameters are allowed: see man(7), man(1)
|
|
.TH A2ENCONF 8 "14 February 2012"
|
|
.\" Please adjust this date whenever revising the manpage.
|
|
.\"
|
|
.\" Some roff macros, for reference:
|
|
.\" .nh disable hyphenation
|
|
.\" .hy enable hyphenation
|
|
.\" .ad l left justify
|
|
.\" .ad b justify to both left and right margins
|
|
.\" .nf disable filling
|
|
.\" .fi enable filling
|
|
.\" .br insert line break
|
|
.\" .sp <n> insert n+1 empty lines
|
|
.\" for manpage-specific macros, see man(7)
|
|
.SH NAME
|
|
a2enconf, a2disconf \- enable or disable an apache2 configuration file
|
|
.SH SYNOPSIS
|
|
.B a2enconf
|
|
[\-q|\-\-quiet] [\-m|\-\-maintmode] [
|
|
.IR configuration
|
|
]
|
|
.PP
|
|
.B a2disconf
|
|
[\-q|\-\-quiet] [\-m|\-\-maintmode] [\-p|\-\-purge] [
|
|
.IR configuration
|
|
]
|
|
.SH DESCRIPTION
|
|
This manual page documents briefly the
|
|
.B a2enconf
|
|
and
|
|
.B a2disconf
|
|
commands.
|
|
.PP
|
|
.B a2enconf
|
|
is a script that enables the specified configuration file within the
|
|
.B apache2
|
|
configuration. It does this by creating symlinks within
|
|
.BR /etc/apache2/conf-enabled .
|
|
Likewise,
|
|
.B a2disconf
|
|
disables a specific configuration part by removing those symlinks. It is not an
|
|
error to enable a configuration which is already enabled, or to disable one which is
|
|
already disabled.
|
|
.PP
|
|
Note that many configuration file may have a dependency to specific modules.
|
|
Unlike module dependencies, these are not resolved automatically. Configuration
|
|
fragments stored in the conf-available directory are considered non-essential or
|
|
being installed and manged by reverse dependencies (e.g. web scripts).
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-q, \-\-quiet
|
|
Don't show informative messages.
|
|
.TP
|
|
.B \-m, \-\-maintmode
|
|
Enables the maintainer mode, that is the program invocation is effectuated
|
|
automatically by a maintainer script. This switch should not be used by end
|
|
users.
|
|
.TP
|
|
.B \-p, \-\-purge
|
|
When disabling a module, purge all traces of the module in the internal state
|
|
data base.
|
|
.SH "EXIT STATUS"
|
|
.B a2enconf
|
|
and
|
|
.B a2disconf
|
|
exit with status 0 if all
|
|
.IR configuration s
|
|
are processed successfully, 1 if errors occur, 2 if an invalid option was used.
|
|
.SH EXAMPLES
|
|
.RS
|
|
.B "a2enconf security"
|
|
.br
|
|
.B "a2disconf charset"
|
|
.RE
|
|
.PP
|
|
Enables Apache security directives stored in the
|
|
.B security
|
|
configuration files, and disables the
|
|
.B charset
|
|
configuration.
|
|
.SH FILES
|
|
.TP
|
|
.B /etc/apache2/conf-available
|
|
Directory with files giving information on available configuration files.
|
|
.TP
|
|
.B /etc/apache2/conf-enabled
|
|
Directory with links to the files in
|
|
.B conf-available
|
|
for enabled configuration files.
|
|
.SH "SEE ALSO"
|
|
.BR apache2ctl (8),
|
|
.BR a2enmod (8),
|
|
.BR a2dismod (8),
|
|
.BR a2ensite (8),
|
|
.BR a2dissite (8).
|
|
.SH AUTHOR
|
|
This manual page was written by Arno Toell <debian@toell.net> for the Debian
|
|
GNU/Linux distribution, as it is a Debian-specific script with the package.
|