<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>vchattr - Changes the attributes on one or more virtual users</title>
<link rev="made" href="mailto:Gentoo@lorien.untroubled.org" />
</head>
<body style="background-color: white">
<p><a name="__index__"></a></p>
<!-- INDEX BEGIN -->
<!--
<ul>
<li><a href="#name">NAME</a></li>
<li><a href="#synopsis">SYNOPSIS</a></li>
<li><a href="#description">DESCRIPTION</a></li>
<li><a href="#options">OPTIONS</a></li>
<li><a href="#return_value">RETURN VALUE</a></li>
<li><a href="#see_also">SEE ALSO</a></li>
<li><a href="#notes">NOTES</a></li>
<li><a href="#authors">AUTHORS</a></li>
</ul>
-->
<!-- INDEX END -->
<p>
</p>
<h1><a name="name">NAME</a></h1>
<p>vchattr - Changes the attributes on one or more virtual users</p>
<p>
</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>
<p>
</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>
<p>
</p>
<hr />
<h1><a name="options">OPTIONS</a></h1>
<dl>
<dt><strong><a name="item__2dc_2c__2d_2dmsgcount"><strong>-c</strong>, <strong>--msgcount</strong></a></strong><br />
</dt>
<dd>
Set the user's message count limit.
</dd>
<p></p>
<dt><strong><a name="item__2de_2c__2d_2dexpiry"><strong>-e</strong>, <strong>--expiry</strong></a></strong><br />
</dt>
<dd>
Set the account's expiry time (in seconds).
</dd>
<p></p>
<dt><strong><a name="item__2de_2c__2d_2denabled"><strong>-E</strong>, <strong>--enabled</strong></a></strong><br />
</dt>
<dd>
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.
</dd>
<p></p>
<dt><strong><a name="item__2dp_2c__2d_2dpersonal"><strong>-p</strong>, <strong>--personal</strong></a></strong><br />
</dt>
<dd>
Set the user's personal information.
</dd>
<p></p>
<dt><strong><a name="item__2dq_2c__2d_2dsoftquota"><strong>-q</strong>, <strong>--softquota</strong></a></strong><br />
</dt>
<dd>
Set the user's soft quota (in bytes).
</dd>
<p></p>
<dt><strong><a name="item__2dq_2c__2d_2dhardquota"><strong>-Q</strong>, <strong>--hardquota</strong></a></strong><br />
</dt>
<dd>
Set the user's hard quota (in bytes).
</dd>
<p></p>
<dt><strong><a name="item__2d_2dquiet"><strong>--quiet</strong></a></strong><br />
</dt>
<dd>
Suppress all status messages.
</dd>
<p></p>
<dt><strong><a name="item__2dz_2c__2d_2dmsgsize"><strong>-z</strong>, <strong>--msgsize</strong></a></strong><br />
</dt>
<dd>
Set the user's message size limit (in bytes).
</dd>
<p></p></dl>
<p>
</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>
<p>
</p>
<hr />
<h1><a name="see_also">SEE ALSO</a></h1>
<p><code>vadduser(1)</code></p>
<p>
</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>
<p>
</p>
<hr />
<h1><a name="authors">AUTHORS</a></h1>
<p>Bruce Guenter <<a href="mailto:bruceg@em.ca">bruceg@em.ca</a>></p>
</body>
</html>