components/sendmail/files/man/newaliases.1m
changeset 3649 4006eaaa7d29
equal deleted inserted replaced
3648:29c40c98aad3 3649:4006eaaa7d29
       
     1 '\" te
       
     2 .\"  Copyright (c) 2001 Sun Microsystems, Inc.  All Rights Reserved.
       
     3 .TH newaliases 1M "14 Sep 2001" "SunOS 5.12" "System Administration Commands"
       
     4 .SH NAME
       
     5 newaliases \- rebuild the data base for the mail aliases file
       
     6 .SH SYNOPSIS
       
     7 .LP
       
     8 .nf
       
     9 \fBnewaliases\fR 
       
    10 .fi
       
    11 
       
    12 .SH DESCRIPTION
       
    13 .sp
       
    14 .LP
       
    15 \fBnewaliases\fR rebuilds the random access data base for the mail aliases file \fB/etc/mail/aliases\fR.
       
    16 .sp
       
    17 .LP
       
    18 \fBnewaliases\fR accepts all the flags that \fBsendmail\fR(1M) accepts. However, most of these flags have no effect, except for the \fB-C\fR option and three of the \fBProcessing\fR \fBOptions\fR that can be set from a configuration file with the \fB-o\fR option:
       
    19 .sp
       
    20 .ne 2
       
    21 .mk
       
    22 .na
       
    23 \fB\fB-C\fR\fI /path/to/alt/config/file\fR\fR
       
    24 .ad
       
    25 .sp .6
       
    26 .RS 4n
       
    27 Use alternate configuration file.
       
    28 .RE
       
    29 
       
    30 .sp
       
    31 .ne 2
       
    32 .mk
       
    33 .na
       
    34 \fB\fB-oA\fR\fIfile\fR\fR
       
    35 .ad
       
    36 .sp .6
       
    37 .RS 4n
       
    38 Specify possible alias files.
       
    39 .RE
       
    40 
       
    41 .sp
       
    42 .ne 2
       
    43 .mk
       
    44 .na
       
    45 \fB\fB-oL\fR\fIn\fR\fR
       
    46 .ad
       
    47 .sp .6
       
    48 .RS 4n
       
    49 Set the default log level to \fIn\fR. Defaults to \fB9\fR.
       
    50 .RE
       
    51 
       
    52 .sp
       
    53 .ne 2
       
    54 .mk
       
    55 .na
       
    56 \fB\fB-on\fR\fR
       
    57 .ad
       
    58 .sp .6
       
    59 .RS 4n
       
    60 Validate the \fBRHS\fR of aliases when rebuilding the \fBaliases\fR(4) database.
       
    61 .RE
       
    62 
       
    63 .sp
       
    64 .LP
       
    65 \fBnewaliases\fR runs in verbose mode (\fB-v\fR option) automatically.
       
    66 .SH EXAMPLES
       
    67 .LP
       
    68 \fBExample 1 \fRRunning the \fBnewaliases\fR Command
       
    69 .sp
       
    70 .LP
       
    71 The following command runs \fBnewaliases\fR on an alias file different from the \fB/etc/mail/aliases\fR default in \fBsendmail\fR(1M):
       
    72 
       
    73 .sp
       
    74 .in +2
       
    75 .nf
       
    76  example% \fBnewaliases \fR\fB-oA\fR\fB\fI/path/to/alternate/alias/file\fR\fR
       
    77 .fi
       
    78 .in -2
       
    79 .sp
       
    80 
       
    81 .SH EXIT STATUS
       
    82 .sp
       
    83 .LP
       
    84 \fBnewaliases\fR returns an exit status describing what it did. The codes are defined in \fB/usr/include/sysexits.h\fR.
       
    85 .sp
       
    86 .ne 2
       
    87 .mk
       
    88 .na
       
    89 \fB\fBEX_OK\fR\fR
       
    90 .ad
       
    91 .RS 18n
       
    92 .rt  
       
    93 Successful completion on all addresses.
       
    94 .RE
       
    95 
       
    96 .sp
       
    97 .ne 2
       
    98 .mk
       
    99 .na
       
   100 \fB\fBEX_NOUSER\fR\fR
       
   101 .ad
       
   102 .RS 18n
       
   103 .rt  
       
   104 User name not recognized.
       
   105 .RE
       
   106 
       
   107 .sp
       
   108 .ne 2
       
   109 .mk
       
   110 .na
       
   111 \fB\fBEX_UNAVAILABLE\fR\fR
       
   112 .ad
       
   113 .RS 18n
       
   114 .rt  
       
   115 Catchall. Necessary resources were not available.
       
   116 .RE
       
   117 
       
   118 .sp
       
   119 .ne 2
       
   120 .mk
       
   121 .na
       
   122 \fB\fBEX_SYNTAX\fR\fR
       
   123 .ad
       
   124 .RS 18n
       
   125 .rt  
       
   126 Syntax error in address.
       
   127 .RE
       
   128 
       
   129 .sp
       
   130 .ne 2
       
   131 .mk
       
   132 .na
       
   133 \fB\fBEX_SOFTWARE\fR\fR
       
   134 .ad
       
   135 .RS 18n
       
   136 .rt  
       
   137 Internal software error, including bad arguments.
       
   138 .RE
       
   139 
       
   140 .sp
       
   141 .ne 2
       
   142 .mk
       
   143 .na
       
   144 \fB\fBEX_OSERR\fR\fR
       
   145 .ad
       
   146 .RS 18n
       
   147 .rt  
       
   148 Temporary operating system error, such as "cannot fork".
       
   149 .RE
       
   150 
       
   151 .sp
       
   152 .ne 2
       
   153 .mk
       
   154 .na
       
   155 \fB\fBEX_NOHOST\fR\fR
       
   156 .ad
       
   157 .RS 18n
       
   158 .rt  
       
   159 Host name not recognized.
       
   160 .RE
       
   161 
       
   162 .sp
       
   163 .ne 2
       
   164 .mk
       
   165 .na
       
   166 \fB\fBEX_TEMPFAIL\fR\fR
       
   167 .ad
       
   168 .RS 18n
       
   169 .rt  
       
   170 Message could not be sent immediately, but was queued.
       
   171 .RE
       
   172 
       
   173 .SH FILES
       
   174 .sp
       
   175 .ne 2
       
   176 .mk
       
   177 .na
       
   178 \fB\fB/etc/aliases\fR\fR
       
   179 .ad
       
   180 .RS 25n
       
   181 .rt  
       
   182 Symbolic link to \fB/etc/mail/aliases\fR
       
   183 .RE
       
   184 
       
   185 .sp
       
   186 .ne 2
       
   187 .mk
       
   188 .na
       
   189 \fB\fB/etc/mail/aliases.pag\fR\fR
       
   190 .ad
       
   191 .RS 25n
       
   192 .rt  
       
   193  
       
   194 .RE
       
   195 
       
   196 .sp
       
   197 .ne 2
       
   198 .mk
       
   199 .na
       
   200 \fB\fB/etc/mail/aliases.dir\fR\fR
       
   201 .ad
       
   202 .RS 25n
       
   203 .rt  
       
   204 \fBndbm\fR files maintained by \fBnewaliases\fR
       
   205 .RE
       
   206 
       
   207 .sp
       
   208 .ne 2
       
   209 .mk
       
   210 .na
       
   211 \fB\fB/etc/mail/aliases.db\fR\fR
       
   212 .ad
       
   213 .RS 25n
       
   214 .rt  
       
   215 Berkeley DataBase file maintained by newaliases
       
   216 .RE
       
   217 
       
   218 .SH ATTRIBUTES
       
   219 .sp
       
   220 .LP
       
   221 See \fBattributes\fR(5) for descriptions of the following attributes:
       
   222 .sp
       
   223 
       
   224 .sp
       
   225 .TS
       
   226 tab() box;
       
   227 cw(2.75i) |cw(2.75i) 
       
   228 lw(2.75i) |lw(2.75i) 
       
   229 .
       
   230 ATTRIBUTE TYPEATTRIBUTE VALUE
       
   231 _
       
   232 Availabilityservice/network/smtp/sendmail
       
   233 .TE
       
   234 
       
   235 .SH SEE ALSO
       
   236 .sp
       
   237 .LP
       
   238 \fBsendmail\fR(1M), \fBaliases\fR(4), \fBattributes\fR(5)