commands/vadduser.1
changeset 0 6f7a81934006
child 2 b3afb9f1e801
equal deleted inserted replaced
-1:000000000000 0:6f7a81934006
       
     1 .rn '' }`
       
     2 ''' $RCSfile$$Revision$$Date$
       
     3 '''
       
     4 ''' $Log$
       
     5 '''
       
     6 .de Sh
       
     7 .br
       
     8 .if t .Sp
       
     9 .ne 5
       
    10 .PP
       
    11 \fB\\$1\fR
       
    12 .PP
       
    13 ..
       
    14 .de Sp
       
    15 .if t .sp .5v
       
    16 .if n .sp
       
    17 ..
       
    18 .de Ip
       
    19 .br
       
    20 .ie \\n(.$>=3 .ne \\$3
       
    21 .el .ne 3
       
    22 .IP "\\$1" \\$2
       
    23 ..
       
    24 .de Vb
       
    25 .ft CW
       
    26 .nf
       
    27 .ne \\$1
       
    28 ..
       
    29 .de Ve
       
    30 .ft R
       
    31 
       
    32 .fi
       
    33 ..
       
    34 '''
       
    35 '''
       
    36 '''     Set up \*(-- to give an unbreakable dash;
       
    37 '''     string Tr holds user defined translation string.
       
    38 '''     Bell System Logo is used as a dummy character.
       
    39 '''
       
    40 .tr \(*W-|\(bv\*(Tr
       
    41 .ie n \{\
       
    42 .ds -- \(*W-
       
    43 .ds PI pi
       
    44 .if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
       
    45 .if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
       
    46 .ds L" ""
       
    47 .ds R" ""
       
    48 '''   \*(M", \*(S", \*(N" and \*(T" are the equivalent of
       
    49 '''   \*(L" and \*(R", except that they are used on ".xx" lines,
       
    50 '''   such as .IP and .SH, which do another additional levels of
       
    51 '''   double-quote interpretation
       
    52 .ds M" """
       
    53 .ds S" """
       
    54 .ds N" """""
       
    55 .ds T" """""
       
    56 .ds L' '
       
    57 .ds R' '
       
    58 .ds M' '
       
    59 .ds S' '
       
    60 .ds N' '
       
    61 .ds T' '
       
    62 'br\}
       
    63 .el\{\
       
    64 .ds -- \(em\|
       
    65 .tr \*(Tr
       
    66 .ds L" ``
       
    67 .ds R" ''
       
    68 .ds M" ``
       
    69 .ds S" ''
       
    70 .ds N" ``
       
    71 .ds T" ''
       
    72 .ds L' `
       
    73 .ds R' '
       
    74 .ds M' `
       
    75 .ds S' '
       
    76 .ds N' `
       
    77 .ds T' '
       
    78 .ds PI \(*p
       
    79 'br\}
       
    80 .\"	If the F register is turned on, we'll generate
       
    81 .\"	index entries out stderr for the following things:
       
    82 .\"		TH	Title 
       
    83 .\"		SH	Header
       
    84 .\"		Sh	Subsection 
       
    85 .\"		Ip	Item
       
    86 .\"		X<>	Xref  (embedded
       
    87 .\"	Of course, you have to process the output yourself
       
    88 .\"	in some meaninful fashion.
       
    89 .if \nF \{
       
    90 .de IX
       
    91 .tm Index:\\$1\t\\n%\t"\\$2"
       
    92 ..
       
    93 .nr % 0
       
    94 .rr F
       
    95 .\}
       
    96 .TH VADDUSER 1 "vmailmgr 0.96.9" "2000-09-30" "VMailMgr Tools Documentation"
       
    97 .UC
       
    98 .if n .hy 0
       
    99 .if n .na
       
   100 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
       
   101 .de CQ          \" put $1 in typewriter font
       
   102 .ft CW
       
   103 'if n "\c
       
   104 'if t \\&\\$1\c
       
   105 'if n \\&\\$1\c
       
   106 'if n \&"
       
   107 \\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
       
   108 '.ft R
       
   109 ..
       
   110 .\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
       
   111 .	\" AM - accent mark definitions
       
   112 .bd B 3
       
   113 .	\" fudge factors for nroff and troff
       
   114 .if n \{\
       
   115 .	ds #H 0
       
   116 .	ds #V .8m
       
   117 .	ds #F .3m
       
   118 .	ds #[ \f1
       
   119 .	ds #] \fP
       
   120 .\}
       
   121 .if t \{\
       
   122 .	ds #H ((1u-(\\\\n(.fu%2u))*.13m)
       
   123 .	ds #V .6m
       
   124 .	ds #F 0
       
   125 .	ds #[ \&
       
   126 .	ds #] \&
       
   127 .\}
       
   128 .	\" simple accents for nroff and troff
       
   129 .if n \{\
       
   130 .	ds ' \&
       
   131 .	ds ` \&
       
   132 .	ds ^ \&
       
   133 .	ds , \&
       
   134 .	ds ~ ~
       
   135 .	ds ? ?
       
   136 .	ds ! !
       
   137 .	ds /
       
   138 .	ds q
       
   139 .\}
       
   140 .if t \{\
       
   141 .	ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
       
   142 .	ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
       
   143 .	ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
       
   144 .	ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
       
   145 .	ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
       
   146 .	ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
       
   147 .	ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
       
   148 .	ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
       
   149 .	ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
       
   150 .\}
       
   151 .	\" troff and (daisy-wheel) nroff accents
       
   152 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
       
   153 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
       
   154 .ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
       
   155 .ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
       
   156 .ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
       
   157 .ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
       
   158 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
       
   159 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
       
   160 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
       
   161 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
       
   162 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
       
   163 .ds ae a\h'-(\w'a'u*4/10)'e
       
   164 .ds Ae A\h'-(\w'A'u*4/10)'E
       
   165 .ds oe o\h'-(\w'o'u*4/10)'e
       
   166 .ds Oe O\h'-(\w'O'u*4/10)'E
       
   167 .	\" corrections for vroff
       
   168 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
       
   169 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
       
   170 .	\" for low resolution devices (crt and lpr)
       
   171 .if \n(.H>23 .if \n(.V>19 \
       
   172 \{\
       
   173 .	ds : e
       
   174 .	ds 8 ss
       
   175 .	ds v \h'-1'\o'\(aa\(ga'
       
   176 .	ds _ \h'-1'^
       
   177 .	ds . \h'-1'.
       
   178 .	ds 3 3
       
   179 .	ds o a
       
   180 .	ds d- d\h'-1'\(ga
       
   181 .	ds D- D\h'-1'\(hy
       
   182 .	ds th \o'bp'
       
   183 .	ds Th \o'LP'
       
   184 .	ds ae ae
       
   185 .	ds Ae AE
       
   186 .	ds oe oe
       
   187 .	ds Oe OE
       
   188 .\}
       
   189 .rm #[ #] #H #V #F C
       
   190 .SH "NAME"
       
   191 vadduser \- Add a user to a virtual domain
       
   192 .SH "SYNOPSIS"
       
   193 \fBvadduser\fR
       
   194 [\fB\-c INT\fR]
       
   195 [\fB--msgcount=INT\fR]
       
   196 [\fB\-D\fR]
       
   197 [\fB--no-mailbox\fR]
       
   198 [\fB\-d STR\fR]
       
   199 [\fB--directory=STR\fR]
       
   200 [\fB\-e INT\fR]
       
   201 [\fB--expiry=INT\fR]
       
   202 [\fB\-f STR\fR]
       
   203 [\fB--forward=STR\fR]
       
   204 [\fB\-P\fR]
       
   205 [\fB--no-password\fR]
       
   206 [\fB\-p STR\fR]
       
   207 [\fB--personal=STR\fR]
       
   208 [\fB\-Q INT\fR]
       
   209 [\fB--hardquota=INT\fR]
       
   210 [\fB\-q INT\fR]
       
   211 [\fB--softquota=INT\fR]
       
   212 [\fB--quiet\fR]
       
   213 [\fB\-z INT\fR]
       
   214 [\fB--msgsize=INT\fR]
       
   215 \fIUSERNAME [ALIAS1 ...]\en"
       
   216 \*(L"or vaddalias [\-f ADDRESS] USERNAME [ALIAS1 ...]\fR
       
   217 .SH "DESCRIPTION"
       
   218 This program is used to set up a user within a virtual host.
       
   219 If this program is reading from a tty,
       
   220 it will then ask for a password (twice, to make sure you typed it in
       
   221 correctly), otherwise it will read the password from the input with no
       
   222 prompting.
       
   223 It will then
       
   224 add the user to the virtual password table in the current
       
   225 directory and create a mail directory for the new user.
       
   226 It will also add an entry for each of the named aliases.
       
   227 .SH "OPTIONS"
       
   228 .Ip "\fB\-c \s-1INT\s0\fR, \fB--msgcount=\s-1INT\s0\fR" 8
       
   229 Set the user's message count limit.
       
   230 .Ip "\fB\-D\fR, \fB--no-mailbox\fR" 8
       
   231 Do not create a mailbox for this user. Defaults to true for vaddalias.
       
   232 .Ip "\fB\-d \s-1STR\s0\fR, \fB--directory=\s-1STR\s0\fR" 8
       
   233 Set the path to the user's mailbox. Note that this directory is unconditionally prefixed with \*(L"./\*(R".
       
   234 .Ip "\fB\-e \s-1INT\s0\fR, \fB--expiry=\s-1INT\s0\fR" 8
       
   235 Set the account's expiry time (in seconds).
       
   236 .Ip "\fB\-f \s-1STR\s0\fR, \fB--forward=\s-1STR\s0\fR" 8
       
   237 Add a forwarding address to this user (this may be used multiple times).
       
   238 .Ip "\fB\-P\fR, \fB--no-password\fR" 8
       
   239 Do not ask for a password, and instead set the pass phrase field to an unusable value.
       
   240 .Ip "\fB\-p \s-1STR\s0\fR, \fB--personal=\s-1STR\s0\fR" 8
       
   241 Set the user's personal information.
       
   242 .Ip "\fB\-Q \s-1INT\s0\fR, \fB--hardquota=\s-1INT\s0\fR" 8
       
   243 Set the user's hard quota (in bytes).
       
   244 .Ip "\fB\-q \s-1INT\s0\fR, \fB--softquota=\s-1INT\s0\fR" 8
       
   245 Set the user's soft quota (in bytes).
       
   246 .Ip "\fB--quiet\fR" 8
       
   247 Suppress all status messages.
       
   248 .Ip "\fB\-z \s-1INT\s0\fR, \fB--msgsize=\s-1INT\s0\fR" 8
       
   249 Set the user's message size limit (in bytes).
       
   250 .SH "RETURN VALUE"
       
   251 0 if all steps were successful, non-zero otherwise.
       
   252 If any of the steps fail, a diagnostic message is printed.
       
   253 .SH "SEE ALSO"
       
   254 \fIvsetup\fR\|(1)
       
   255 .SH "NOTES"
       
   256 You must have either created the users subdirectory by hand or run the
       
   257 \fIvsetup\fR program before using this program.
       
   258 .PP
       
   259 This program expects the environment variable \f(CWHOME\fR to be set, and
       
   260 executes a change directory to the contents of it before starting.  It
       
   261 is also required that you change user to the domain owner before using
       
   262 these utilities.
       
   263 .SH "AUTHORS"
       
   264 Bruce Guenter <bruceg@em.ca>
       
   265 
       
   266 .rn }` ''
       
   267 .IX Title "VADDUSER 1"
       
   268 .IX Name "vadduser - Add a user to a virtual domain"
       
   269 
       
   270 .IX Header "NAME"
       
   271 
       
   272 .IX Header "SYNOPSIS"
       
   273 
       
   274 .IX Header "DESCRIPTION"
       
   275 
       
   276 .IX Header "OPTIONS"
       
   277 
       
   278 .IX Item "\fB\-c \s-1INT\s0\fR, \fB--msgcount=\s-1INT\s0\fR"
       
   279 
       
   280 .IX Item "\fB\-D\fR, \fB--no-mailbox\fR"
       
   281 
       
   282 .IX Item "\fB\-d \s-1STR\s0\fR, \fB--directory=\s-1STR\s0\fR"
       
   283 
       
   284 .IX Item "\fB\-e \s-1INT\s0\fR, \fB--expiry=\s-1INT\s0\fR"
       
   285 
       
   286 .IX Item "\fB\-f \s-1STR\s0\fR, \fB--forward=\s-1STR\s0\fR"
       
   287 
       
   288 .IX Item "\fB\-P\fR, \fB--no-password\fR"
       
   289 
       
   290 .IX Item "\fB\-p \s-1STR\s0\fR, \fB--personal=\s-1STR\s0\fR"
       
   291 
       
   292 .IX Item "\fB\-Q \s-1INT\s0\fR, \fB--hardquota=\s-1INT\s0\fR"
       
   293 
       
   294 .IX Item "\fB\-q \s-1INT\s0\fR, \fB--softquota=\s-1INT\s0\fR"
       
   295 
       
   296 .IX Item "\fB--quiet\fR"
       
   297 
       
   298 .IX Item "\fB\-z \s-1INT\s0\fR, \fB--msgsize=\s-1INT\s0\fR"
       
   299 
       
   300 .IX Header "RETURN VALUE"
       
   301 
       
   302 .IX Header "SEE ALSO"
       
   303 
       
   304 .IX Header "NOTES"
       
   305 
       
   306 .IX Header "AUTHORS"
       
   307