Changes between Initial Version and Version 1 of MasterPasswdSyntax


Ignore:
Timestamp:
Feb 3, 2008, 10:46:55 AM (16 years ago)
Author:
Herwig Bauernfeind
Comment:

Syntax of master.passwd file

Legend:

Unmodified
Added
Removed
Modified

  • MasterPasswdSyntax

    v1 v1  
     1= Syntax of master.passwd =
     2
     3The master.passwd is a text file with every line holding exactly one user.
     4
     5''Note: The user information in master.passwd is a prerequisite for Samba's own user information.
     6
     7One line consists of several fields delimited by a ":".
     8
     9Sample line with all fields:
     10
     11{{{Username:password:UID:GID:Login-Class:Change pw in x sec:Deactivate in x sec:GECOS:HOME:SHELL}}}
     12
     13||'''Field'''||'''Description'''||'''Recommended value when using Samba'''||'''Example
     14||Username||Username that should be used to login||Required field||{{{herwig}}}
     15||Password||Not used currently||Leave empty or add * as value||{{{*}}}
     16||UID||User-ID||Required, give each user a unique number||{{{110}}}
     17||GID||Group-ID||Required. If groups are not used, same value as UID||{{{110}}}
     18||Login-Class||Not used currently||Set to zero (0)||{{{0}}}
     19||Change pw in x sec||Not used currently||Set to zero (0)||{{{0}}}
     20||Deactivate pw in x sec||Not used currently||Set to zero (0)||{{{0}}}
     21||GECOS||Full username||Useful, but not completely supported||{{{Herwig Bauernfeind}}}
     22||Home||The user's home directory||Don't use it currently(*)||{{{/nonexistent}}}
     23||Shell||The user's shell||Not used currently||{{{/usr/sbin/nologin}}}
     24
     25With the examples from the above table, a valid line in {{{master.passwd}}} would look like the following line:
     26
     27{{{# This is a comment in master.passwd}}}
     28{{{herwig:*:110:110:0:0:0:Herwig Bauernfeind:/nonexistent:/usr/sbin/nologin}}}
     29
     30(*) You cannot enter a valid OS/2 path in this field as the ":" would be misinterpreted as a field delimiter resulting in a broken master.passwd. It is possible to use the kLibc PathRewriter to workaround this limitation, but this is currently not recommended.
     31
     32''Note: Use the [homes] section of smb.conf in case home directories should be used.''