commands/vadduser.html
changeset 0 6f7a81934006
child 2 b3afb9f1e801
equal deleted inserted replaced
-1:000000000000 0:6f7a81934006
       
     1 <HTML>
       
     2 <HEAD>
       
     3 <TITLE>vadduser - Add a user to a virtual domain</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 vadduser - Add a user to a virtual domain
       
    30 
       
    31 <P>
       
    32 <HR>
       
    33 <H1><A NAME="SYNOPSIS">SYNOPSIS</A></H1>
       
    34 <P>
       
    35 <STRONG>vadduser</STRONG>
       
    36 [<STRONG>-c INT</STRONG>] [<STRONG>--msgcount=INT</STRONG>] [<STRONG>-D</STRONG>] [<STRONG>--no-mailbox</STRONG>] [<STRONG>-d STR</STRONG>] [<STRONG>--directory=STR</STRONG>] [<STRONG>-e INT</STRONG>] [<STRONG>--expiry=INT</STRONG>] [<STRONG>-f STR</STRONG>] [<STRONG>--forward=STR</STRONG>] [<STRONG>-P</STRONG>] [<STRONG>--no-password</STRONG>] [<STRONG>-p STR</STRONG>] [<STRONG>--personal=STR</STRONG>] [<STRONG>-Q INT</STRONG>] [<STRONG>--hardquota=INT</STRONG>] [<STRONG>-q INT</STRONG>] [<STRONG>--softquota=INT</STRONG>] [<STRONG>--quiet</STRONG>] [<STRONG>-z INT</STRONG>] [<STRONG>--msgsize=INT</STRONG>]
       
    37 <EM>USERNAME [ALIAS1 ...]\n"
       
    38 "or vaddalias [-f ADDRESS] USERNAME [ALIAS1 ...]</EM>
       
    39 
       
    40 
       
    41 
       
    42 <P>
       
    43 <HR>
       
    44 <H1><A NAME="DESCRIPTION">DESCRIPTION</A></H1>
       
    45 <P>
       
    46 This program is used to set up a user within a virtual host. If this
       
    47 program is reading from a tty, it will then ask for a password (twice, to
       
    48 make sure you typed it in correctly), otherwise it will read the password
       
    49 from the input with no prompting. It will then add the user to the virtual
       
    50 password table in the current directory and create a mail directory for the
       
    51 new user. It will also add an entry for each of the named aliases.
       
    52 
       
    53 <P>
       
    54 <HR>
       
    55 <H1><A NAME="OPTIONS">OPTIONS</A></H1>
       
    56 <DL>
       
    57 <DT><STRONG><A NAME="item__c">-c INT, --msgcount=INT</A></STRONG><DD>
       
    58 <P>
       
    59 Set the user's message count limit.
       
    60 
       
    61 <DT><STRONG><A NAME="item__D_">-D, --no-mailbox</A></STRONG><DD>
       
    62 <P>
       
    63 Do not create a mailbox for this user. Defaults to true for vaddalias.
       
    64 
       
    65 <DT><STRONG><A NAME="item__d">-d STR, --directory=STR</A></STRONG><DD>
       
    66 <P>
       
    67 Set the path to the user's mailbox. Note that this directory is
       
    68 unconditionally prefixed with ``./''.
       
    69 
       
    70 <DT><STRONG><A NAME="item__e">-e INT, --expiry=INT</A></STRONG><DD>
       
    71 <P>
       
    72 Set the account's expiry time (in seconds).
       
    73 
       
    74 <DT><STRONG><A NAME="item__f">-f STR, --forward=STR</A></STRONG><DD>
       
    75 <P>
       
    76 Add a forwarding address to this user (this may be used multiple times).
       
    77 
       
    78 <DT><STRONG><A NAME="item__P_">-P, --no-password</A></STRONG><DD>
       
    79 <P>
       
    80 Do not ask for a password, and instead set the pass phrase field to an
       
    81 unusable value.
       
    82 
       
    83 <DT><STRONG><A NAME="item__p">-p STR, --personal=STR</A></STRONG><DD>
       
    84 <P>
       
    85 Set the user's personal information.
       
    86 
       
    87 <DT><STRONG><A NAME="item__Q">-Q INT, --hardquota=INT</A></STRONG><DD>
       
    88 <P>
       
    89 Set the user's hard quota (in bytes).
       
    90 
       
    91 <DT><STRONG><A NAME="item__q">-q INT, --softquota=INT</A></STRONG><DD>
       
    92 <P>
       
    93 Set the user's soft quota (in bytes).
       
    94 
       
    95 <DT><STRONG><A NAME="item__quiet">--quiet</A></STRONG><DD>
       
    96 <P>
       
    97 Suppress all status messages.
       
    98 
       
    99 <DT><STRONG><A NAME="item__z">-z INT, --msgsize=INT</A></STRONG><DD>
       
   100 <P>
       
   101 Set the user's message size limit (in bytes).
       
   102 
       
   103 </DL>
       
   104 <P>
       
   105 <HR>
       
   106 <H1><A NAME="RETURN_VALUE">RETURN VALUE</A></H1>
       
   107 <P>
       
   108 0 if all steps were successful, non-zero otherwise. If any of the steps
       
   109 fail, a diagnostic message is printed.
       
   110 
       
   111 <P>
       
   112 <HR>
       
   113 <H1><A NAME="SEE_ALSO">SEE ALSO</A></H1>
       
   114 <P>
       
   115 <CODE>vsetup(1)</CODE>
       
   116 
       
   117 <P>
       
   118 <HR>
       
   119 <H1><A NAME="NOTES">NOTES</A></H1>
       
   120 <P>
       
   121 You must have either created the users subdirectory by hand or run the
       
   122 <EM>vsetup</EM> program before using this program.
       
   123 
       
   124 <P>
       
   125 This program expects the environment variable <CODE>HOME</CODE> to be set, and executes a change directory to the contents of it before
       
   126 starting. It is also required that you change user to the domain owner
       
   127 before using these utilities.
       
   128 
       
   129 <P>
       
   130 <HR>
       
   131 <H1><A NAME="AUTHORS">AUTHORS</A></H1>
       
   132 <P>
       
   133 Bruce Guenter &lt;<A HREF="mailto:bruceg@em.ca">bruceg@em.ca</A>&gt;
       
   134 
       
   135 </BODY>
       
   136 
       
   137 </HTML>