Fork: 0
tundra / mkapachepw
Browse code
First cut of completed document.
master
1 parent 37bf87f commit a508b7a565d00a24c232e088f9bafab75e0c9dd7
@toor toor authored on 12 Apr 2005
Patch
Unified Split
Showing 1 changed file
View
79
■■■■■
 mkapachepw.1
.B -O group filename
 
Names the file to which group information will be written. (default:
\fC./.htgroups\fP). The file is produced with read permission for the
owner only. Be sure to change the owner/group for this file as
appropriate for your Apache installation, when actually installing it.
owner only. Before installing the file, be sure to change the
owner/group for this file as appropriate for your Apache installation.
 
If you specify \fC-\fP here, group output is written to stdout.
 
.TP
.B -o user filename
 
Names the file to which user information will be written. (default:
\fC./.htusers\fP). The file is produced with read permission for the
owner only. Be sure to change the owner/group for this file as
appropriate for your Apache installation, when actually installing it.
owner only. Before installing the file, be sure to change the
owner/group for this file as appropriate for your Apache installation.
 
 
If you specify \fC-\fP here, group output is written to stdout.
 
print detailed version information.
 
 
.SH EXAMPLES
 
Output files will contain only system groups and users whose GIDs/UIDs are 100 or higher:
 
.ft C \" Courier
.nf
mkapachepw.py
.fi
 
 
Output files will contain system groups and user whose GIDs/UIDs are 100 or higher, and
all the groups found in \fCgroups.inc\fP. If any of the groups in this included
file has the same name as a system group, the program will emit an error and halt,
writing no output:
 
.ft \" revert
 
.ft C \" Courier
.nf
mkapachepw.py -c -I groups.inc
.fi
.ft \" revert
 
 
The output files will contain all system groups and users whose GIDs/UIDs are
100 or higher
.B except
the groups \fCwheel\fP and \fCbin\fP and the users \fCroot\fP and \fCbin\fP,
which will not appear in the final group and user files respectively:
 
.ft C \" Courier
.nf
mkapachepw.py -G "-wheel -bin" -U "-root -bin"
.fi
.ft \" revert
 
Only the entries in the included files will be processed. No system
groups or users will be present in the final output:
 
.ft C \" Courier
.nf
mkapachepw.py -s -I mygroups.inc -i myusers.inc
.fi
.ft \" revert
 
.B Nothing
is included by default. Only the entries explicitly enumerated by
the \fC-G\fP and \fC-U\fP options will be included from both the
system and included file entries:
 
.ft C \" Courier
.nf
mkapachepw.py -g 100001 -u 100001 -I ... -i ... -G ... -U ...
.fi
.ft \" revert
 
 
.SH EXIT CODES
.ft C \" Courier
.nf
.ft \" revert
 
 
 
.SH OTHER
.SH OTHER NOTES
\fCmkapachepw\fP is a pure-Python module and should run anywhere a
recent Python implementation is found. However, it is Unix-specific
in that it requires the \'pwd\' and \'grp\' modules for accessing the
underlying OS user and group databases. Note that access to these
on other Unix-like variants.
 
The program will not run on Win32 systems.
 
Output files are "stamped" with comments containing the program
version, the time, the date, and the command line that produced that
file.
 
 
.SH BUGS AND MISFEATURES
None known as of this release.
 
.fi
.ft \" revert
 
.SH DOCUMENT REVISION INFORMATION
$Id: mkapachepw.1,v 1.104 2005/04/12 09:49:08 toor Exp $
 
 
 
$Id: mkapachepw.1,v 1.105 2005/04/12 10:05:36 toor Exp $