Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
TABLE_PASSWD(5)		      File Formats Manual	       TABLE_PASSWD(5)

NAME
       table_passwd -- format description for smtpd passwd tables

DESCRIPTION
       This  manual  page documents the	file format of "passwd"	tables used by
       the smtpd(8) mail daemon.

       The  format  described  here  applies   to   tables   as	  defined   in
       smtpd.conf(5).

PASSWD TABLE
       A  "passwd" table stores	information regarding local users.  The	infor-
       mation is encoded using the traditional passwd(5) format	and allows the
       sharing of a user database across different  software  supporting  this
       format.

       The  table  is used by smtpd(8) when authenticating a user or when user
       information such	as user-id or home directory is	required for a	deliv-
       ery.

       A  "passwd"  table consists of a	flat file containing the user entries,
       each one	on a line by itself, with fields separated by a	colon:

	     gilles:*:1000:1000:Gilles:/home/gilles:/sbin/nologin
	     eric:*:1001:1001:Eric:/home/eric:/sbin/nologin
	     chl:*:1002:1002:Charles:/home/chl:/sbin/nologin

       Besides the first username field	 and  depending	 on  the  table	 type,
       fields  are optional and	might be empty.	 The gecos and the shell field
       are not used and	ignored.

       If the table is used for	authentication,	the second field  should  con-
       tain  a password	encrypted using	the crypt(3) function.	Such passwords
       can be generated	using the encrypt(1)  utility  or  smtpctl(8)  encrypt
       command.

       If  the table is	used for user information, user-id, group-id, and home
       directory fields	are required.

       In favor	of supporting shared authentication with the  Dovecot  Passwd-
       file  format,  extra fields after the last shell	field are allowed (and
       ignored).

SEE ALSO
       passwd(5), smtpd.conf(5), smtpctl(8), smtpd(8)

HISTORY
       The first version of table_passwd was written in	2013.

AUTHORS
       table_passwd was	intially written by Gilles Chehade  <gilles@poolp.org>
       and further improved by Joerg Jung <jung@openbsd.org>.

FreeBSD	Ports 14.quarterly     February	4, 2014		       TABLE_PASSWD(5)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=table-passwd&sektion=5&manpath=FreeBSD+Ports+14.3.quarterly>

home | help