wiki:MasterPasswdSyntax

Version 5 (modified by herwigb, 11 years ago) (diff)

Typo

Syntax of master.passwd

The master.passwd is a text file with every line holding exactly one user. It is located in %UNIXROOT\etc.

Note: The user information in master.passwd is a prerequisite for Samba's own user information.

One line consists of several fields delimited by a ":".

Sample line with all fields:

Username:password:UID:GID:Login-Class:Change pw in x sec:Deactivate in x sec:GECOS:HOME:SHELL

FieldDescriptionRecommended value when using SambaExample
UsernameUsername that should be used to loginRequired fieldherwig
PasswordNot used currentlyLeave empty or add * as value*
UIDUser-IDRequired, give each user a unique number110
GIDGroup-IDRequired. If groups are not used, same value as UID110
Login-ClassNot used currentlyLeave empty
Change pw in x secNot used currentlySet to zero (0)0
Deactivate pw in x secNot used currentlySet to zero (0)0
GECOSFull usernameUseful, but not completely supportedHerwig Bauernfeind
HomeThe user's home directoryEnter path, see Note below||D$/Samba/User/herwig
ShellThe user's shellNot used currently/usr/sbin/nologin

With the examples from the above table, a valid line in master.passwd would look like the following line:

# This is a comment in master.passwd herwig:*:110:110::0:0:Herwig Bauernfeind:D$/Samba/User/herwig:/usr/sbin/nologin

Note: You must enter a valid OS/2 path in this field and replace the ":" following the driveletter by a "$", otherwise the ":" would be misinterpreted as a field delimiter resulting in a broken master.passwd.

Note: This works on Samba builds newer than 04/02/2008 with Ticket #44 fixed.

Syntax of group

The group is a text file with every line holding exactly one group and its assoiciated users. It is located in %UNIXROOT\etc.

One line consists of several fields delimited by a ":".

Sample line of the group file:

group name:group password:GID:list of users in this group

FieldDescriptionRecommended value when using SambaExample
group nameThe name of the group A simple text describing the groupadmins
group passwordCommon password for all membersNot used currently (Or better: Not tested yet)*
GIDGroup-IDGive each group a unique number3000
List of usersseparated by commasAll users, that are members of this grouproot,toor

With the examples similar to the above table, a valid group file would look like the following:

# This is a comment in the group file
admin:*:3000:root,psmedley,ydario,
users:*:3001:herwig,gabriele,
guests:*:3002:guest,pcguest,

Note: One user can be a member of multiple groups.

Note: Having at least these 3 groups is recommended.

Note: Don't forget the trailing comma after the last user!