# $Id$

=head1 DESCRIPTION

Unix base type support standard unix users and groups base, eg C<password> and
C<group> file normally located in C</etc>.

This base support has written to support C<NIS> database, generated over this
files.

Managing the system file with this module is at your own risk.

Unlike other base support, this module need direct read and write permission to
filesystem. Ensure tools and daemon are run using ocrrect user.

=head1 SPECIFIC SETUP PARAMTERS

=head2 directory

The directory where files are located. If not specified F</etc> is assumed.

=head2 use_shadow

If set to true, F<shadow> and F<gshadow> are generated, password in F<passwd>
file are replace by C<x>. This also mean attributes stored in shadow files are
supported.

=head2 nis_overflow 

Some version of C<NIS> base dont support line longer than 4096 bytes, which
happend if you have lot of people in a specific groups.

This parameter provide ways to avoid this problem (notice it concern only the
F<group> file.

=over 4

=item <unset>

No specific action is taken, line is writen as is into the output file.

=item kill

An error is report and the line is simply remove from the output. Information
will be missing but at least the C<NIS> database will still works

=item truncate

The member list is truncate to not exceed the 4096 byte limit (member list is
sorted alphabetically).

=item split

Group members are split into severals differents groups having same C<GID>. This
mean for last users checking they are in the groups will fails but permission
checks on filesystem will still apply correctly.

The ouput look like this:

    group:500:x:aa,bb,cc
    group_1:500:x,dd,ee,ff

=item encoding

Specify the encoding of the file. Default is C<iso-8859-15>.

=back