.ds CP 2005 .TH mkapachepw 1 "TundraWare Inc." .SH NAME mkapachepw \- Apache webserver user and group file management utility for Unix-like systems. .SH SYNOPSIS mkapachepw [-sGUguIicqOohv] .SH DESCRIPTION \'mkapachepw\' is a utility program for creating and maintaining Apache webserver user and group access control files. Its primary value is that it allows large numbers of user and group entries to be managed in separate files. These files are then combined into single, production files for use by the Apache webserver. In this manner, different departments of an organization can independently manage their own user and group information in separate files. The webmaster then uses \'mkapachepw\' to combine them on the production system. \'mkapachepw\' has a number of useful features, including: .IP \(bu 4 Automatically Create Apache Users/Groups From Underlying OS Users/Groups .IP \(bu 4 Combine User & Group Data From Separately Managed Files Into Single Production Apache Access Control Files .IP \(bu 4 Specify Which Particular Users/Groups Are To Be Included Or Excluded .IP \(bu 4 Catch (And Prevent) Redefinition Of User/Groups In Different Files .P With \'mkapachepw\', you can easily write scripts to automate the creation of custom Apache user and group access control files that contain any/all of the OS users/groups plus any other custom users and groups relevant to your Apache installation. For example, you might have separately managed user/group files for Engineering, Sales, and Marketing. These can then be selectively combined with the users/groups already defined by the underlying operating system. .SH INSTALLATION FreeBSD users can simply install the package using the \'mkapachepw\' port. All other Unix-like systems require the program to be installed manually: .IP \(bu 4 Get the distribution tarball from http://www.tundraware.com/Software/mkapachepw .IP \(bu 4 Copy the \'mkapachepw.py\' file to a directory somewhere in your path. .IP \(bu 4 Copy the \'mkapachepw.1.gz\' file to the local \'man1\' directory. .SH OPTIONS .TP .B -s suppress inclusion system user and group information By default, \'mkapachepw\' includes the users and groups found in the underlying operating system (starting with the specified starting GID and UID - see the -g and -u options below). This command line option prevents any system users or groups from being included in the final output files. .TP .B -G .TP .B -U .TP .B -g .TP .B -u .TP .B -I .TP .B -i .TP .B -c .TP .B -q .TP .B -O .TP .B -o .TP .B -h print help information .TP .B -v print detailed version information. .SH EXAMPLES .SH EXIT CODES .ft C \" Courier .nf 0 No error, normal completion 1 Invalid command line: - Cannot open include file - Invalid command line option - Extraneous argument(s) after command line options - Invalid argument for starting GID or UID 2 Invalid enumeration argument: - Enumerated entry missing an inclusion/exclusion prefix (+/-) - Attempt to include/exclude a non-existent GID, UID, or name 3 Cannot open output file 4 Included file attempted to redefine existing user or group .fi .ft \" revert .SH OTHER \'mkapachepw\' 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 system databases requires the program be run by the root user. In order for this program to produce correct access control files, Apache and the underlying OS must agree on the hash algorithm used to encrypt passwords. This should be the default case in most instances. This program has only been tested on FreeBSD, though it should work on other Unix-like variants. The program will not run on Win32 systems. .SH BUGS AND MISFEATURES None known as of this release. .SH COPYRIGHT AND LICENSING \'mkapachepw\' is Copyright (c) \*(CP TundraWare Inc. For terms of use, see the mkapachepw-license.txt file in the program distribution. If you install \'mkapachepw\' on a FreeBSD system using the 'ports' mechanism, you will also find this file in /usr/local/share/doc/mkapachepw. \'mkapachepw\' is free for individual, non-commerical, personal use. Use in any setting where there is any remuneration, direct or indirect, requires payment of a licensing fee. Individual, multiple, and enterprise licensing is available. Contact mkapachepw@tundraware.com for current pricing. .SH AUTHOR .ft C \" Courier .nf Tim Daneliuk mkapachepw@tundraware.com .fi .ft \" revert .SH DOCUMENT REVISION INFORMATION $Id: mkapachepw.1,v 1.102 2005/04/12 08:28:28 toor Exp $