mh-gen.8

早期freebsd实现

.sp
To have \fIMH\fP POP use the new assigned port number, 
set POPSERVICE='\*(lqpop3\*(rq', and be sure that this service
name is listed in your \fB/etc/services\fP file on both POP client
and server hosts as \*(lq110/tcp\*(rq.
If you enable \fIPOP2\fP, you can safely leave \fIPOPSERVICE\fP
undefined unless you are using POP3 clients besides \fIMH\fP.

.ti -.5i
RPOP
.br
This option indicates that support for the UNIX variant of POP,
RPOP, which uses privileged sockets for authentication be enabled.
This peacefully co-exists with the standard POP.

.ti -.5i
SHADOW
.br
Indicates that the \fBpopd\fP POP server
can find encrypted passwords in the
\fB/etc/shadow\fR file (and not in the \fB/etc/passwd\fR file).
It should be used only for some (newer) SYSTEM 5 systems.
.in -.25i

The \*(lqAPOP\*(rq and \*(lqMPOP\*(rq non-standard POP
facilities are documented in
\fIThe Internet Message\fR (ISBN 0\-13\-092941\-7),
a book by Marshall T. Rose.
For more details, see \fBsupport/pop/pop-more.txt\fR.
The \*(lqAPOP\*(rq option peacefully co-exists with the standard POP.
The \*(lqMPOP\*(rq option requires \*(lqbboards: pop\*(rq.

.Uh "Shared libraries"
.ti -.5i
sharedlib: off
.br
If \*(lqsun4\*(rq,
makes libmh.a into a SunOS 4.0 (and later) shared library.
If you enable this, be sure to also use \*(lqoptions SUN40\*(rq.
If \*(lqsys5\*(rq, 
makes libmh.a into a SYS5 R4 (and later) shared library.
If you enable this, be sure to also use \*(lqoptions SVR4\*(rq.

.ti -.5i
slflags: \-pic
.br
The compiler flags to produce position independent code.

.ti -.5i
slibdir: /usr/local/lib
.br
The directory where the \fIMH\fP shared library should go.

.ne 4
.ti -.25i
Under SunOS (sun4)
.br
Since some \fIMH\fP programs are setuid, they'll only look for
the library in \*(lqtrusted\*(rq locations.  Putting the library
somewhere besides \fB/usr/lib\fP or \fB/usr/local/lib\fP is not advisable.

If you \fBmust\fP do this, be sure that you add the 
path given by \fBslibdir\fP to the compiler's library search list 
(e.g., \*(lqldoptions:\0\-L/usr/mh/lib\*(rq)
and make sure the path starts with a leading `/'.

You may need to run \fIldconfig\fP\|(8) manually whenever a new
shared object is installed on the system.
See \fIld\fR\|(1) for more information about using shared libraries.

.ti -.25i
Under Solaris 2.0 (and newer)
.br
The above instructions for SunOS apply, except you should set
the run-time library search path using `\-R' instead of `\-L'
(e.g., \*(lqldoptions: \-R/usr/mh/lib\*(rq).

.Uh "General System Dependencies"
.in -.5i
You should include the following directives 
which are appropriate for your version of UNIX.
If you don't know what an
option does, it probably doesn't apply to you.
.in +.5i

.ti -.5i
mailgroup: off
.br
If set, \fIinc\fR is made set-group-id to this group name.
Some SYS5 systems want this to be set to \*(lqmail\*(rq.
Set this if your \fB/usr/spool/mail\fP is not world-writeable.

Note that \fBslocal\fP doesn't know how to deal with this,
and will not work under these systems; just making it set-group-id
will open a security hole.
If you're using \*(lqmailgroup\*(rq,
you should remove \fBslocal\fP (and its man page) from your system.

.ti -.5i
signal: int
.br
The base type (int or void) of the function
parameter/return value of \fIsignal\fR\|(2).
The default is \fBint\fR.
Set \*(lqsignal void\*(rq on systems which use this type
(e.g., SYSTEM 5 V3.0 and later or Sun OS 4.0 and later).

.ti -.5i
sprintf: char *
.br
The return value of the \fIsprintf\fR library routine.
This defaults to \*(lqchar\0*\*(rq.  Set this to \*(lqint\*(rq if
you have an older version of SYSTEM 5 which has this routine return an
\*(lqint\*(rq type.

.ne 5
.ti -.5i
options:
.br
\&`\-D' options to \fIcc\fR\|(1).
.sp
.in +.25i
.ti -.5i
ALTOS
.br
Use on XENIX/v7 systems.
Also, be sure to use \*(lqoptions V7\*(rq.

.ti -.5i
ATTVIBUG
.br
This option causes
\fIMH\fP to return to the \*(lqWhat now?\*(rq
prompt if your initial editor is \fBvi\fP
and it exits with non-zero status.
Use on Sun OS 4.1 and other systems where the
\fB/usr/ucb/vi\fP editor was changed to
exit with its status equal to the number of pseudo-\*(lqerrors\*(rq
encountered during the edit.  This causes a problem for programs that
test the exit status of their editor and abort if the status is non-zero.
(This includes \fIMH\fP and programs like \fB/usr/etc/vipw\fP).

.ti -.5i
AUX
.br
Use with AUX systems.

.ti -.5i
BIND
.br
If you are running with the BIND code on UNIX systems
with TCP/IP sockets (e.g. 4.{2,3}BSD),
be sure to define this.

.ti -.5i
BSD41A
.br
Use on 4.1a Berkeley UNIX systems.

.ti -.5i
BSD42
.br
Use on Berkeley UNIX systems on or after 4.2BSD.

.ti -.5i
BSD43
.br
Use on 4.3 Berkeley UNIX systems.
Also, be sure to use \*(lqoptions BSD42\*(rq.
If \fIopenlog\fR\|(3) (see \*(lqman 3 syslog\*(rq)
takes three arguments instead of two,
and your \fIwrite\fR\|(1) command is set\-group\-id
to group \*(lqtty\*(rq, use this option.
If only one of these conditions is true, you lose.

.ti -.5i
BSD44
.br
Use on Berkeley UNIX systems on or after 4.4BSD.
Also, be sure to use \*(lqoptions BSD43\*(rq
and \*(lqoptions BSD42\*(rq.

.ti -.5i
DBMPWD
.br
Use this option if your \fIgetpwent\fR\|(3) routines read a 
dbm database (such as with Yellow Pages) instead of doing
a sequential read of \fB/etc/passwd\fR.
Without DBMPWD the entire passwd file is read into
memory one entry at a time for alias expansion.
This is a performance improvement when reading
a standard \fB/etc/passwd\fR file,
but is \fIvery\fR slow on systems with a dbm database.
At one site that runs
YP on a large passwd file, it showed a 6:1 performance improvement.

.ti -.5in
GCOS_HACK
.br
The so-called \*(lqgcos\*(rq field of the password file is 
used as a last resort
to find the user's full name (see \fImh-profile\fP\|(5) for details).
Enable this option
if your \fIpasswd\fP\|(5) man page notes that the `&'
character in the \*(lqgcos\*(rq field stands for the login name.

.ti -.5i
FCNTL
.br
Directs \fIMH\fP to use the \fBfcntl()\fP system call for kernel-level
locking.  If you're using a SYS5 system, you may want
this option.  (See also `FLOCK' and `LOCKF').

.ti -.5i
FLOCK
.br
Directs \fIMH\fP to use the \fBflock()\fP system call for kernel-level
locking.  If you're on a BSD42 system,
and you're not using NFS to read or write maildrops,
you should enable this option.  (See also `FCNTL' and `LOCKF').

.ti -.5i
HESIOD
.br
Support for HESIOD.  
This code was contributed, and included no documentation.

.ti -.5i
LOCKF
.br
Directs \fIMH\fP to use the \fBlockf()\fP system call for kernel-level
locking.  If you're using NFS to read or
write maildrops, you should enable this option.  (See also `FLOCK'
and `FCNTL').

.ti -.5i
locname
.br
Hard-wires the local name for the host \fIMH\fR is running on.
For example, locname='\*(lqPICKLE\*(rq'.
It's probably better to either let UNIX tell \fIMH\fR this information,
or to put the information in the host specific \fBmtstailor\fR file.

.ti -.5i
MORE
.br
Defines  the location of the \fImore\fR\|(1) program.
On ALTOS and DUAL systems, set
MORE='\*(lq/usr/bin/more\*(rq'.
The default is \*(lq/usr/ucb/more\*(rq.

.ti -.5i
NDIR
.br
For non-Berkeley UNIX systems,
this \fIMH\fR will try to find the new directory access mechanism by looking
in \fB<ndir.h>\fR if this option is given.
Otherwise, \fIMH\fR will try \fB<dir.h>\fR.
If you still can't get this to work on your system,
edit \fBh/local.h\fR as appropriate.
(See also `SYS5DIR'.)

.ti -.5i
NFS
.br
Tells \fIMH\fR to hack around a problem in the NFS C library.
If you get an undefined symbol \*(lqruserpass\*(rq when compiling
\fIMH\fP, you probably need this option.  If, however, you include this
option and get an undefined symbol \*(lq\(ru\^\(ruruserpass\*(rq
when compiling, then you should omit this option.
(See also `NORUSERPASS'.)

.ti -.5i
NOIOCTLH
.br
Tells \fIMH\fR not to include the file \fB<sys/ioctl.h>\fR.
To be used on systems where this file is not present.

.ti -.5i
NORUSERPASS
.br
Tells \fIMH\fR that your system doesn't have the
\fIruserpass\fP\|(3) routine;
\fIMH\fR will include its own copy of this
routine in its library.
(See also `NFS'.)

.ti -.5i
NTOHLSWAP
.br
Tells \fIMH\fR to use the \fBntohl()\fR macro when processing
\fImsh\fR binary map files.  \fIMH\fR can use this macro on
systems with the include file \fBnetinet/in.h\fR,
to byte-swap the binary information in these map files.
If you're using the same map files on machines of different
architectures, enable this option.

.ti -.5i
RENAME
.br
Include this option if your system has a \fBrename()\fP library
call.  This is true on BSD42 and newer and some SYS5 systems.

.ti -.5i
SENDMAILBUG
.br
Causes SMTP reply code 451 (failure)
to be considered the same as code 250 (OK).
Since this might cause problems, only
enable this if you are certain that your SendMail will
return this code even when it doesn't mean to indicate a failure.

.\" .ti -.5i
.\" SMTP_ONEX
.\" .br
.\" Causes \fIMH\fP to give the \*(lqONEX\*(rq SMTP command
.\" when posting mail (a SendMail performance hack).
.\" Useful only if you're running a SendMail
.\" which will successfully reset with the \*(lqRSET\*(rq command
.\" after seeing the \*(lqONEX\*(rq command;
.\" otherwise, if you enable this 
.\" you may have problems posting messages with \*(lqBCCs\*(rq.
.\" 
.ti -.5i
SOCKETS
.br
Indicates the availability of a socket interface
for TCP/IP networking that is compatible with 4.{2,3}BSD UNIX.
It is not necessary to define this when BSD42 is already defined,
but it might be useful for SYSTEM 5 or HPUX systems with TCP/IP sockets.

.ti -.5i
SUN40
.br
Use on Sun OS 4.0 (and later?) systems.  You also will need
\*(lqoptions BSD42\*(rq, \*(lqoptions BSD43\*(rq, and
\*(lqsignal void\*(rq.

If you're using Sun's brain-damaged approach to offering Domain
Name Service through NIS, be sure to include
\*(lqoptions BIND\*(rq and
\*(lqldoptions \-lresolv\*(rq to work around some NIS/DNS bugs.

.ti -.5i
SYS5
.br
Use on AT&T SYSTEM 5 R3 (and newer?) UNIX systems.  See also \fImailgroup\fR.

.ti -.5i
SYS5DIR
.br
Define this if your system uses \*(lqstruct dirent\*(rq
instead of \*(lqstruct direct\*(rq.
This is true of System V Release 3.0 and later.
Uses include file \fB<dirent.h>\fR
and the routines \fImkdir\fR, \fIrmdir\fR and \fIgetcwd\fR.

.ti -.5i
SVR4
.br
Use on AT&T SYSTEM 5 R4 (and newer?) UNIX systems. You should 
also include \*(lqoptions SYS5\*(rq and \*(lqoptions SYS5DIR\*(rq.
See also \fImailgroup\fR.
You will also need to include \*(lqoldload none\*(rq if your \fBld\fP
doesn't handle `\-x\0\-r' correctly.

.ti -.5i
TERMINFO
.br
Define TERMINFO if you have it.
You get it automatically if you're running SYS5, and you don't get
it if you're not.  (If you're not SYS5, you probably have termcap.)

.ti -.5i
TZNAME
.br
Use time zone names from the \fItzname\fR variable, set via \fItzset\fR.
Only applicable on SYSTEM 5 systems and only effective when you have
asked for alpha\-timezones (see the ATZ option).  See also ZONEINFO.

.ti -.5i
UNISTD
.br
Include this option if your system has the file \fB<unistd.h>\fP.
If not specified, the LOCKF option will include \fB<sys/fcntl.h>\fP.

.ti -.5i
V7
.br
Use on V7 UNIX systems.
Also, be sure to use \*(lqoptions void=int\*(rq.

.ti -.5i
VSPRINTF
.br
Include this option if your system has the \fIvsprintf\fP\|(3)
library routine; otherwise, \fI\(rudoprnt\fP\|(3) will be used.

.ti -.5i
WAITINT
.br
BSD42 based systems call the \fIwait\fP\|(2)
system routine with a pointer to type \fIunion wait\fP.
Include this option if you included \*(lqoptions BSD42\*(rq, but
your system calls the \fIwait\fP\|(2)
system routine with a pointer to type \fIint\fP
(the non-BSD42 default).

.ti -.5i
ZONEINFO
.br
Specify this if you have a BSD43 based system that keeps time zone
information /etc/zoneinfo or /usr/lib/zoneinfo (SunOS),
and where 
the \fIstruct tm\fP 
returned by \fIlocaltime\fP\|(3) contains a \fItm_gmtoff\fP element
(see \fB/usr/include/time.h\fP).
With this fix the GMT offset specified in outgoing mail
will be corrected when the TZ enviornment variable is set
to a different time zone.  See also TZNAME.
.in -.25i

.Uh "Site Preferences"
.br
.in -.5i
These options change the
default behavior of \fIMH\fP or enable optional features.
Add the options which are appropriate for your configuration 
or your site preferences.
.in +.5i

.ti -.5i
editor: prompter
.br
The default editor for \fIMH\fR.

.ne 5
.ti -.5i
options:
.br
\&`\-D' options to \fIcc\fR\|(1).
.sp
.in +.25i
.ne 4
.ti -.5i
ATZ
.br
Directs \fIMH\fR to use alpha\-timezones whenever possible.
You should not use this option if you are on the Internet,
since it will make your host non-compliant with RFC-1123
(Requirements for Internet Hosts).

.ti -.5i
ATHENA
.br
Makes \fIrepl\fR `\-nocc\0all' the default instead of `\-cc\0all'.
You may want to enable this if you're using \fIxmh\fR.

.ti -.5i
BANG
.br
Directs \fIMH\fR to favor `!' over `@' in addressing.

.ti -.5i
BERK
.br
Optional for for 4.{2,3}BSD sites running SendMail.
Disables nearly all of the RFC822 address and header-parsing routines
in favor of recognizing such formats as ASCnet, and so on.
If you don't need to disable the parser for this reason,
you probably want to use \*(lqoptions DUMB\*(rq instead.

.ti -.5i
COMPAT
.br
If you previously ran a version of \fIMH\fR earlier than mh.4 use this option.
After a short grace period,
remove it and re-{configure,generate,install} everything.

.ti -.5i