summaryrefslogtreecommitdiffstats
path: root/debian/manpages/a2ensite.8
diff options
context:
space:
mode:
Diffstat (limited to 'debian/manpages/a2ensite.8')
-rw-r--r--debian/manpages/a2ensite.897
1 files changed, 97 insertions, 0 deletions
diff --git a/debian/manpages/a2ensite.8 b/debian/manpages/a2ensite.8
new file mode 100644
index 0000000..d11f4bb
--- /dev/null
+++ b/debian/manpages/a2ensite.8
@@ -0,0 +1,97 @@
+.\" 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 A2ENSITE 8 "8 June 2007"
+.\" 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
+a2ensite, a2dissite \- enable or disable an apache2 site / virtual host
+.SH SYNOPSIS
+.B a2ensite
+[\-q|\-\-quiet] [\-m|\-\-maintmode] [
+.IR site
+]
+.PP
+.B a2dissite
+[\-q|\-\-quiet] [\-m|\-\-maintmode] [\-p|\-\-purge] [
+.IR site
+]
+.SH DESCRIPTION
+This manual page documents briefly the
+.B a2ensite
+and
+.B a2dissite
+commands.
+.PP
+.B a2ensite
+is a script that enables the specified site (which contains a <VirtualHost> block) within the
+.B apache2
+configuration. It does this by creating symlinks within
+.BR /etc/apache2/sites-enabled .
+Likewise,
+.B a2dissite
+disables a site by removing those symlinks. It is not an error to
+enable a site which is already enabled, or to disable one which is
+already disabled.
+.PP
+Apache treats the very first virtual host enabled specially as every request not
+matching any actual directive is being redirected there. Thus it should be called
+.B 000-default
+in order to sort before the remaining hosts to be loaded first.
+.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 a2ensite
+and
+.B a2dissite
+exit with status 0 if all
+.IR site s
+are processed successfully, 1 if errors occur, 2 if an invalid option was used.
+.SH EXAMPLES
+.RS
+.B "a2dissite 000-default"
+.RE
+.PP
+Disables the
+.B default
+site.
+.SH FILES
+.TP
+.B /etc/apache2/sites-available
+Directory with files giving information on available sites.
+.TP
+.B /etc/apache2/sites-enabled
+Directory with links to the files in
+.B sites-available
+for enabled sites.
+.SH "SEE ALSO"
+.BR apache2ctl (8),
+.BR a2enmod (8),
+.BR a2dismod (8),
+.BR a2enconf (8),
+.BR a2disconf (8).
+.SH AUTHOR
+This manual page was written by Stefan Fritsch <sf@debian.org> (based on the a2enmod manual
+page by Daniel Stone <daniel@sfarc.net>) for the Debian GNU/Linux distribution.