Current File : //var/qmail/man/cat8/qmail-getpw.0

Maintenance Procedures                             qmail-getpw(8)



NNNNAAAAMMMMEEEE
     qmail-getpw - give addresses to users

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     qqqqmmmmaaaaiiiillll----ggggeeeettttppppwwww _l_o_c_a_l

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     In  qqqqmmmmaaaaiiiillll,  each  user  controls  a  vast  array  of   local
     addresses.   qqqqmmmmaaaaiiiillll----ggggeeeettttppppwwww finds the user that controls a par-
     ticular address, _l_o_c_a_l.  It prints six  pieces  of  informa-
     tion,  each  terminated  by  NUL:   _u_s_e_r; _u_i_d; _g_i_d; _h_o_m_e_d_i_r;
     _d_a_s_h; and _e_x_t.  The user's account name is _u_s_e_r; the  user's
     uid  and  gid  in  decimal  are _u_i_d and _g_i_d; the user's home
     directory is _h_o_m_e_d_i_r; and messages to _l_o_c_a_l will be  handled
     by _h_o_m_e_d_i_r////....qqqqmmmmaaaaiiiillll_d_a_s_h_e_x_t.

     In case of trouble, qqqqmmmmaaaaiiiillll----ggggeeeettttppppwwww exits nonzero without print-
     ing anything.

     WWWWAAAARRRRNNNNIIIINNNNGGGG:::: The operating system's ggggeeeettttppppwwwwnnnnaaaammmm function, which  is
     at  the  heart of qqqqmmmmaaaaiiiillll----ggggeeeettttppppwwww, is inherently unreliable:  it
     fails to distinguish between  temporary  errors  and  nonex-
     istent  users.   Future  versions  of ggggeeeettttppppwwwwnnnnaaaammmm should return
     ETXTBSY to indicate temporary errors and ESRCH  to  indicate
     nonexistent users.

RRRRUUUULLLLEEEESSSS
     qqqqmmmmaaaaiiiillll----ggggeeeettttppppwwww considers an account in ////eeeettttcccc////ppppaaaasssssssswwwwdddd to be a user
     if (1) the account has a nonzero uid, (2) the account's home
     directory exists (and is visible to  qqqqmmmmaaaaiiiillll----ggggeeeettttppppwwww),  and  (3)
     the  account  owns  its home directory.  qqqqmmmmaaaaiiiillll----ggggeeeettttppppwwww ignores
     account names  containing  uppercase  letters.   qqqqmmmmaaaaiiiillll----ggggeeeettttppppwwww
     also  assumes  that  all  account  names are shorter than 32
     characters.

     qqqqmmmmaaaaiiiillll----ggggeeeettttppppwwww gives each user  control  over  the  basic  _u_s_e_r
     address  and  all addresses of the form _u_s_e_r----_a_n_y_t_h_i_n_g.  When
     _l_o_c_a_l is _u_s_e_r, _d_a_s_h and _e_x_t are both empty.  When  _l_o_c_a_l  is
     _u_s_e_r----_a_n_y_t_h_i_n_g,  _d_a_s_h  is a hyphen and _e_x_t is _a_n_y_t_h_i_n_g.  _u_s_e_r
     may appear in any combination  of  uppercase  and  lowercase
     letters at the front of _l_o_c_a_l.

     A catch-all user, aaaalllliiiiaaaassss, controls all other  addresses.   In
     this case _e_x_t is _l_o_c_a_l and _d_a_s_h is a hyphen.

     You can override all of  qqqqmmmmaaaaiiiillll----ggggeeeettttppppwwww's  decisions  with  the
     qqqqmmmmaaaaiiiillll----uuuusssseeeerrrrssss  mechanism,  which is reliable, highly configur-
     able, and much faster than qqqqmmmmaaaaiiiillll----ggggeeeettttppppwwww.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     qmail-users(5), qmail-lspawn(8)




SunOS 5.11                Last change:                          1