commands/vchattr.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 VCHATTR 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 vchattr \- Changes the attributes on one or more virtual users
       
   192 .SH "SYNOPSIS"
       
   193 \fBvchattr\fR
       
   194 [\fB\-c\fR]
       
   195 [\fB--msgcount\fR]
       
   196 [\fB\-e\fR]
       
   197 [\fB--expiry\fR]
       
   198 [\fB\-E\fR]
       
   199 [\fB--enabled\fR]
       
   200 [\fB\-p\fR]
       
   201 [\fB--personal\fR]
       
   202 [\fB\-q\fR]
       
   203 [\fB--softquota\fR]
       
   204 [\fB\-Q\fR]
       
   205 [\fB--hardquota\fR]
       
   206 [\fB--quiet\fR]
       
   207 [\fB\-z\fR]
       
   208 [\fB--msgsize\fR]
       
   209 \fIVALUE USERNAME ...\fR
       
   210 .SH "DESCRIPTION"
       
   211 This program changes the value of one attribute on a set of virtual
       
   212 users.  It cannot be used to change the user's password or forwarding
       
   213 addresses -- use \fBvpasswd\fR and \fBvchforwards\fR to accomplish those
       
   214 tasks.
       
   215 .SH "OPTIONS"
       
   216 .Ip "\fB\-c\fR, \fB--msgcount\fR" 8
       
   217 Set the user's message count limit.
       
   218 .Ip "\fB\-e\fR, \fB--expiry\fR" 8
       
   219 Set the account's expiry time (in seconds).
       
   220 .Ip "\fB\-E\fR, \fB--enabled\fR" 8
       
   221 Enable (\f(CW1\fR) or disable (\f(CW0\fR) delivery to the virtual user's mailbox directory.  This does not delete the mailbox or any of the messages contained in or, nor prevent the user from logging in.
       
   222 .Ip "\fB\-p\fR, \fB--personal\fR" 8
       
   223 Set the user's personal information.
       
   224 .Ip "\fB\-q\fR, \fB--softquota\fR" 8
       
   225 Set the user's soft quota (in bytes).
       
   226 .Ip "\fB\-Q\fR, \fB--hardquota\fR" 8
       
   227 Set the user's hard quota (in bytes).
       
   228 .Ip "\fB--quiet\fR" 8
       
   229 Suppress all status messages.
       
   230 .Ip "\fB\-z\fR, \fB--msgsize\fR" 8
       
   231 Set the user's message size limit (in bytes).
       
   232 .SH "RETURN VALUE"
       
   233 0 if the given attribute was successfully changed for all users,
       
   234 non-zero otherwise.
       
   235 If any of the steps fail, a diagnostic message is printed.
       
   236 .SH "SEE ALSO"
       
   237 \fIvadduser\fR\|(1)
       
   238 .SH "NOTES"
       
   239 This program expects the environment variable \f(CWHOME\fR to be set, and
       
   240 executes a change directory to the contents of it before starting.  It
       
   241 is also required that you change user to the domain owner before using
       
   242 these utilities.
       
   243 .SH "AUTHORS"
       
   244 Bruce Guenter <bruceg@em.ca>
       
   245 
       
   246 .rn }` ''
       
   247 .IX Title "VCHATTR 1"
       
   248 .IX Name "vchattr - Changes the attributes on one or more virtual users"
       
   249 
       
   250 .IX Header "NAME"
       
   251 
       
   252 .IX Header "SYNOPSIS"
       
   253 
       
   254 .IX Header "DESCRIPTION"
       
   255 
       
   256 .IX Header "OPTIONS"
       
   257 
       
   258 .IX Item "\fB\-c\fR, \fB--msgcount\fR"
       
   259 
       
   260 .IX Item "\fB\-e\fR, \fB--expiry\fR"
       
   261 
       
   262 .IX Item "\fB\-E\fR, \fB--enabled\fR"
       
   263 
       
   264 .IX Item "\fB\-p\fR, \fB--personal\fR"
       
   265 
       
   266 .IX Item "\fB\-q\fR, \fB--softquota\fR"
       
   267 
       
   268 .IX Item "\fB\-Q\fR, \fB--hardquota\fR"
       
   269 
       
   270 .IX Item "\fB--quiet\fR"
       
   271 
       
   272 .IX Item "\fB\-z\fR, \fB--msgsize\fR"
       
   273 
       
   274 .IX Header "RETURN VALUE"
       
   275 
       
   276 .IX Header "SEE ALSO"
       
   277 
       
   278 .IX Header "NOTES"
       
   279 
       
   280 .IX Header "AUTHORS"
       
   281