commands/vchattr.html
changeset 0 6f7a81934006
child 2 b3afb9f1e801
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/commands/vchattr.html	Wed Jan 16 22:39:43 2008 +0100
@@ -0,0 +1,117 @@
+<HTML>
+<HEAD>
+<TITLE>vchattr - Changes the attributes on one or more virtual users</TITLE>
+<LINK REV="made" HREF="mailto:root@porky.devel.redhat.com">
+</HEAD>
+
+<BODY>
+
+<!-- INDEX BEGIN -->
+<!--
+
+<UL>
+
+	<LI><A HREF="#NAME">NAME</A>
+	<LI><A HREF="#SYNOPSIS">SYNOPSIS</A>
+	<LI><A HREF="#DESCRIPTION">DESCRIPTION</A>
+	<LI><A HREF="#OPTIONS">OPTIONS</A>
+	<LI><A HREF="#RETURN_VALUE">RETURN VALUE</A>
+	<LI><A HREF="#SEE_ALSO">SEE ALSO</A>
+	<LI><A HREF="#NOTES">NOTES</A>
+	<LI><A HREF="#AUTHORS">AUTHORS</A>
+</UL>
+-->
+<!-- INDEX END -->
+
+<P>
+<H1><A NAME="NAME">NAME</A></H1>
+<P>
+vchattr - Changes the attributes on one or more virtual users
+
+<P>
+<HR>
+<H1><A NAME="SYNOPSIS">SYNOPSIS</A></H1>
+<P>
+<STRONG>vchattr</STRONG>
+[<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>]
+<EM>VALUE USERNAME ...</EM>
+
+
+
+<P>
+<HR>
+<H1><A NAME="DESCRIPTION">DESCRIPTION</A></H1>
+<P>
+This program changes the value of one attribute on a set of virtual users.
+It cannot be used to change the user's password or forwarding addresses --
+use <STRONG>vpasswd</STRONG> and <STRONG>vchforwards</STRONG> to accomplish those tasks.
+
+<P>
+<HR>
+<H1><A NAME="OPTIONS">OPTIONS</A></H1>
+<DL>
+<DT><STRONG><A NAME="item__c_">-c, --msgcount</A></STRONG><DD>
+<P>
+Set the user's message count limit.
+
+<DT><STRONG><A NAME="item__e_">-e, --expiry</A></STRONG><DD>
+<P>
+Set the account's expiry time (in seconds).
+
+<DT><STRONG><A NAME="item__E_">-E, --enabled</A></STRONG><DD>
+<P>
+Enable (<CODE>1</CODE>) or disable (<CODE>0</CODE>) 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.
+
+<DT><STRONG><A NAME="item__p_">-p, --personal</A></STRONG><DD>
+<P>
+Set the user's personal information.
+
+<DT><STRONG><A NAME="item__q_">-q, --softquota</A></STRONG><DD>
+<P>
+Set the user's soft quota (in bytes).
+
+<DT><STRONG><A NAME="item__Q_">-Q, --hardquota</A></STRONG><DD>
+<P>
+Set the user's hard quota (in bytes).
+
+<DT><STRONG><A NAME="item__quiet">--quiet</A></STRONG><DD>
+<P>
+Suppress all status messages.
+
+<DT><STRONG><A NAME="item__z_">-z, --msgsize</A></STRONG><DD>
+<P>
+Set the user's message size limit (in bytes).
+
+</DL>
+<P>
+<HR>
+<H1><A NAME="RETURN_VALUE">RETURN VALUE</A></H1>
+<P>
+0 if the given attribute was successfully changed for all users, non-zero
+otherwise. If any of the steps fail, a diagnostic message is printed.
+
+<P>
+<HR>
+<H1><A NAME="SEE_ALSO">SEE ALSO</A></H1>
+<P>
+<CODE>vadduser(1)</CODE>
+
+<P>
+<HR>
+<H1><A NAME="NOTES">NOTES</A></H1>
+<P>
+This program expects the environment variable <CODE>HOME</CODE> to be set, and executes a change directory to the contents of it before
+starting. It is also required that you change user to the domain owner
+before using these utilities.
+
+<P>
+<HR>
+<H1><A NAME="AUTHORS">AUTHORS</A></H1>
+<P>
+Bruce Guenter &lt;<A HREF="mailto:bruceg@em.ca">bruceg@em.ca</A>&gt;
+
+</BODY>
+
+</HTML>