diff options
Diffstat (limited to 'debian/manpages/a2ensite.8')
-rw-r--r-- | debian/manpages/a2ensite.8 | 97 |
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. |