commands/vchattr.html
changeset 0 6f7a81934006
child 2 b3afb9f1e801
equal deleted inserted replaced
-1:000000000000 0:6f7a81934006
       
     1 <HTML>
       
     2 <HEAD>
       
     3 <TITLE>vchattr - Changes the attributes on one or more virtual users</TITLE>
       
     4 <LINK REV="made" HREF="mailto:root@porky.devel.redhat.com">
       
     5 </HEAD>
       
     6 
       
     7 <BODY>
       
     8 
       
     9 <!-- INDEX BEGIN -->
       
    10 <!--
       
    11 
       
    12 <UL>
       
    13 
       
    14 	<LI><A HREF="#NAME">NAME</A>
       
    15 	<LI><A HREF="#SYNOPSIS">SYNOPSIS</A>
       
    16 	<LI><A HREF="#DESCRIPTION">DESCRIPTION</A>
       
    17 	<LI><A HREF="#OPTIONS">OPTIONS</A>
       
    18 	<LI><A HREF="#RETURN_VALUE">RETURN VALUE</A>
       
    19 	<LI><A HREF="#SEE_ALSO">SEE ALSO</A>
       
    20 	<LI><A HREF="#NOTES">NOTES</A>
       
    21 	<LI><A HREF="#AUTHORS">AUTHORS</A>
       
    22 </UL>
       
    23 -->
       
    24 <!-- INDEX END -->
       
    25 
       
    26 <P>
       
    27 <H1><A NAME="NAME">NAME</A></H1>
       
    28 <P>
       
    29 vchattr - Changes the attributes on one or more virtual users
       
    30 
       
    31 <P>
       
    32 <HR>
       
    33 <H1><A NAME="SYNOPSIS">SYNOPSIS</A></H1>
       
    34 <P>
       
    35 <STRONG>vchattr</STRONG>
       
    36 [<STRONG>-c</STRONG>] [<STRONG>--msgcount</STRONG>] [<STRONG>-e</STRONG>] [<STRONG>--expiry</STRONG>] [<STRONG>-E</STRONG>] [<STRONG>--enabled</STRONG>] [<STRONG>-p</STRONG>] [<STRONG>--personal</STRONG>] [<STRONG>-q</STRONG>] [<STRONG>--softquota</STRONG>] [<STRONG>-Q</STRONG>] [<STRONG>--hardquota</STRONG>] [<STRONG>--quiet</STRONG>] [<STRONG>-z</STRONG>] [<STRONG>--msgsize</STRONG>]
       
    37 <EM>VALUE USERNAME ...</EM>
       
    38 
       
    39 
       
    40 
       
    41 <P>
       
    42 <HR>
       
    43 <H1><A NAME="DESCRIPTION">DESCRIPTION</A></H1>
       
    44 <P>
       
    45 This program changes the value of one attribute on a set of virtual users.
       
    46 It cannot be used to change the user's password or forwarding addresses --
       
    47 use <STRONG>vpasswd</STRONG> and <STRONG>vchforwards</STRONG> to accomplish those tasks.
       
    48 
       
    49 <P>
       
    50 <HR>
       
    51 <H1><A NAME="OPTIONS">OPTIONS</A></H1>
       
    52 <DL>
       
    53 <DT><STRONG><A NAME="item__c_">-c, --msgcount</A></STRONG><DD>
       
    54 <P>
       
    55 Set the user's message count limit.
       
    56 
       
    57 <DT><STRONG><A NAME="item__e_">-e, --expiry</A></STRONG><DD>
       
    58 <P>
       
    59 Set the account's expiry time (in seconds).
       
    60 
       
    61 <DT><STRONG><A NAME="item__E_">-E, --enabled</A></STRONG><DD>
       
    62 <P>
       
    63 Enable (<CODE>1</CODE>) or disable (<CODE>0</CODE>) delivery to the virtual user's mailbox directory. This does not delete
       
    64 the mailbox or any of the messages contained in or, nor prevent the user
       
    65 from logging in.
       
    66 
       
    67 <DT><STRONG><A NAME="item__p_">-p, --personal</A></STRONG><DD>
       
    68 <P>
       
    69 Set the user's personal information.
       
    70 
       
    71 <DT><STRONG><A NAME="item__q_">-q, --softquota</A></STRONG><DD>
       
    72 <P>
       
    73 Set the user's soft quota (in bytes).
       
    74 
       
    75 <DT><STRONG><A NAME="item__Q_">-Q, --hardquota</A></STRONG><DD>
       
    76 <P>
       
    77 Set the user's hard quota (in bytes).
       
    78 
       
    79 <DT><STRONG><A NAME="item__quiet">--quiet</A></STRONG><DD>
       
    80 <P>
       
    81 Suppress all status messages.
       
    82 
       
    83 <DT><STRONG><A NAME="item__z_">-z, --msgsize</A></STRONG><DD>
       
    84 <P>
       
    85 Set the user's message size limit (in bytes).
       
    86 
       
    87 </DL>
       
    88 <P>
       
    89 <HR>
       
    90 <H1><A NAME="RETURN_VALUE">RETURN VALUE</A></H1>
       
    91 <P>
       
    92 0 if the given attribute was successfully changed for all users, non-zero
       
    93 otherwise. If any of the steps fail, a diagnostic message is printed.
       
    94 
       
    95 <P>
       
    96 <HR>
       
    97 <H1><A NAME="SEE_ALSO">SEE ALSO</A></H1>
       
    98 <P>
       
    99 <CODE>vadduser(1)</CODE>
       
   100 
       
   101 <P>
       
   102 <HR>
       
   103 <H1><A NAME="NOTES">NOTES</A></H1>
       
   104 <P>
       
   105 This program expects the environment variable <CODE>HOME</CODE> to be set, and executes a change directory to the contents of it before
       
   106 starting. It is also required that you change user to the domain owner
       
   107 before using these utilities.
       
   108 
       
   109 <P>
       
   110 <HR>
       
   111 <H1><A NAME="AUTHORS">AUTHORS</A></H1>
       
   112 <P>
       
   113 Bruce Guenter &lt;<A HREF="mailto:bruceg@em.ca">bruceg@em.ca</A>&gt;
       
   114 
       
   115 </BODY>
       
   116 
       
   117 </HTML>