1 | # $Id$ |
---|
2 | |
---|
3 | =head1 DESCRIPTION |
---|
4 | |
---|
5 | Unix base type support standard unix users and groups base, eg C<password> and |
---|
6 | C<group> file normally located in C</etc>. |
---|
7 | |
---|
8 | This base support has written to support C<NIS> database, generated over this |
---|
9 | files. |
---|
10 | |
---|
11 | Managing the system file with this module is at your own risk. |
---|
12 | |
---|
13 | Unlike other base support, this module need direct read and write permission to |
---|
14 | filesystem. Ensure tools and daemon are run using ocrrect user. |
---|
15 | |
---|
16 | =head1 SPECIFIC SETUP PARAMTERS |
---|
17 | |
---|
18 | =head2 directory |
---|
19 | |
---|
20 | The directory where files are located. If not specified F</etc> is assumed. |
---|
21 | |
---|
22 | =head2 use_shadow |
---|
23 | |
---|
24 | If set to true, F<shadow> and F<gshadow> are generated, password in F<passwd> |
---|
25 | file are replace by C<x>. This also mean attributes stored in shadow files are |
---|
26 | supported. |
---|
27 | |
---|
28 | =head2 nis_overflow |
---|
29 | |
---|
30 | Some version of C<NIS> base dont support line longer than 4096 bytes, which |
---|
31 | happend if you have lot of people in a specific groups. |
---|
32 | |
---|
33 | This parameter provide ways to avoid this problem (notice it concern only the |
---|
34 | F<group> file. |
---|
35 | |
---|
36 | =over 4 |
---|
37 | |
---|
38 | =item <unset> |
---|
39 | |
---|
40 | No specific action is taken, line is writen as is into the output file. |
---|
41 | |
---|
42 | =item kill |
---|
43 | |
---|
44 | An error is report and the line is simply remove from the output. Information |
---|
45 | will be missing but at least the C<NIS> database will still works |
---|
46 | |
---|
47 | =item truncate |
---|
48 | |
---|
49 | The member list is truncate to not exceed the 4096 byte limit (member list is |
---|
50 | sorted alphabetically). |
---|
51 | |
---|
52 | =item split |
---|
53 | |
---|
54 | Group members are split into severals differents groups having same C<GID>. This |
---|
55 | mean for last users checking they are in the groups will fails but permission |
---|
56 | checks on filesystem will still apply correctly. |
---|
57 | |
---|
58 | The ouput look like this: |
---|
59 | |
---|
60 | group:500:x:aa,bb,cc |
---|
61 | group_1:500:x,dd,ee,ff |
---|
62 | |
---|
63 | =item encoding |
---|
64 | |
---|
65 | Specify the encoding of the file. Default is C<iso-8859-15>. |
---|
66 | |
---|
67 | =back |
---|