= Syntax of master.passwd = 

The master.passwd is a text file with every line holding exactly one user.

''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}}}

||'''Field'''||'''Description'''||'''Recommended value when using Samba'''||'''Example
||Username||Username that should be used to login||Required field||{{{herwig}}}
||Password||Not used currently||Leave empty or add * as value||{{{*}}}
||UID||User-ID||Required, give each user a unique number||{{{110}}}
||GID||Group-ID||Required. If groups are not used, same value as UID||{{{110}}}
||Login-Class||Not used currently||Leave empty||{{{ }}}
||Change pw in x sec||Not used currently||Set to zero (0)||{{{0}}}
||Deactivate pw in x sec||Not used currently||Set to zero (0)||{{{0}}}
||GECOS||Full username||Useful, but not completely supported||{{{Herwig Bauernfeind}}}
||Home||The user's home directory||Enter path(*)||{{{D$/Samba/User/herwig}}}
||Shell||The user's shell||Not 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.