summaryrefslogtreecommitdiffstats
path: root/debian/manpages/a2enconf.8
diff options
context:
space:
mode:
Diffstat (limited to 'debian/manpages/a2enconf.8')
-rw-r--r--debian/manpages/a2enconf.8101
1 files changed, 101 insertions, 0 deletions
diff --git a/debian/manpages/a2enconf.8 b/debian/manpages/a2enconf.8
new file mode 100644
index 0000000..7cd2df4
--- /dev/null
+++ b/debian/manpages/a2enconf.8
@@ -0,0 +1,101 @@
+.\" 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.