diff --git a/mkapachepw.1 b/mkapachepw.1 index 62d1977..5962754 100644 --- a/mkapachepw.1 +++ b/mkapachepw.1 @@ -253,8 +253,8 @@ 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. @@ -263,8 +263,8 @@ 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. @@ -280,6 +280,61 @@ .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 @@ -303,7 +358,7 @@ -.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 @@ -320,6 +375,10 @@ 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. @@ -346,7 +405,7 @@ .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 $