@(#)README.NeXT 1.2 (Leon von Stauber) 4/2/98 +--------------+ | DISTRIBUTION | +--------------+ This is a source-only distribution. You will need developer tools to compile the sources. This is not a full source distribution of sendmail. Most non-NeXT-related items and configuration examples are not included. The full sendmail source distribution can be obtained at ftp.sendmail.org. Source for the GNU m4 macro processor is also included in this distribution. m4 is used to create the sendmail configuration file. (See cf/README.NeXT.) The latest version of this distribution should be at ftp.next.peak.org, and also at http://www.occam.com/leonvs/computer/sendmail/. If you run into problems specific to this distribution, send email to . Report more general problems to . +--------------------------+ | COMPILING AND INSTALLING | +--------------------------+ DO NOT USE makesendmail. There are modified Makefiles in each of the following subdirectories: mail.local, mailstats, makemap, smrsh, and src. If you need to change any options, change those Makefiles. In particular, to compile for other NEXTSTEP/OPENSTEP platforms, or to create the formatted man pages from *roff source (using -mandoc), you'll need to fiddle with those Makefiles a little bit. Also, to include support for database formats other than NETINFO, NDBM, or NIS, or to enable tcp_wrappers support, you'll have to make changes to src/Makefile. To compile, simply run "make" from this directory. To install the binaries and man pages, run "make install". (This will need to be done as root.) If you want to start over, run "make clean" first. +------------------+ | ADDITIONAL TASKS | +------------------+ 1) Check your directory permissions, as described in READ_ME. This is what you should probably end up with: Directory Octal Symbolic / 1755 rwxr-xr-t /usr 0755 rwxr-xr-x /private/etc 0755 rwxr-xr-x /private/spool 0755 rwxr-xr-x /private/spool/mqueue 0700 rwx------ /private/spool/mail 1777 rwxrwxrwt 2) Create an /etc/service.switch (as described in the sendmail Installation & Operations Guide). A common setup would look like: hosts: netinfo dns files aliases: netinfo files (This file may or may not be required under OPENSTEP 4.x or Rhapsody. I don't know if sendmail takes advantage of the added functionality in lookupd on those systems.) 3) You may need to include the FQDN (fully qualified domain name) for your host in NetInfo. For instance, for the host named vishnu in the occam.com domain, this could be added with niutil -create . /machines/vishnu.occam.com niutil -createprop . /machines/vishnu.occam.com \ ip_address 206.102.29.100 You could also use NetInfoManager or HostManager. (This may or may not make a difference in your environment. For more information, see "HOST NAME SERVICES" in READ_ME.) 4) Change the location of sendmail.cf listed in NetInfo. This can be done through NetInfoManager, or with the following set of commands: niutil -create . /locations/sendmail niutil -createprop . /locations/sendmail \ sendmail.cf /etc/sendmail.cf 5) Compile and install m4. See INSTALL in the m4 source directory. It's the basic autoconf deal: ./configure make make install If you want to compile for multiple platforms, modify Makefile.in.NeXT. 6) Configure your sendmail installation. See cf/README.NeXT and cf/README. (The sendmail config file will be installed as /etc/sendmail.cf. If you want to keep tabs on everything from the standard /etc/sendmail location of NEXTSTEP, you should just make a symlink to it: ln -s /etc/sendmail.cf /etc/sendmail Make sure to keep a backup of your current config. You can't be too careful when it comes to sendmail configuration. ;) ) 7) You should restart sendmail after all this, and possibly lookupd: kill -HUP `head -1 /etc/sendmail/sendmail.pid` kill -HUP `cat /etc/lookupd.pid` 8) mailstats reports statistics about transferred mail volume, using /etc/sendmail/sendmail.st. You might consider rotating this file on a regular basis, or generating regular reports, perhaps by modifying /usr/adm/weekly or /usr/adm/daily. After rotating the file to a backup copy, zero it out with cp /dev/null /etc/sendmail/sendmail.st There are some example shell scripts for use by cron in the Bat Book (_sendmail, 2nd ed._, Costales & Allman, pp. 447-449). A script is included that will handle some of these steps for many common situations. Simply run "setup.NeXT" in this directory. It's a good idea to run it in test mode first, as "setup-test.NeXT", to make sure it doesn't surprise you. You may need to change the default settings for your environment; this can be done at the beginning of the script. +--------------+ | MANUAL PAGES | +--------------+ The sendmail manual pages use contemporary Berkeley troff macros. (See READ_ME for more.) This means that the included man page "sources" cannot be processed using the macro sets included with NEXTSTEP. The preformatted man pages have already been created and are included in this distribution. The default "install" targets will only install these versions, and the the default "clean" targets will not remove them. One way to get the new macros (and a whole lot more) is to obtain and build groff, which is available via FTP at prep.ai.mit.edu, which compiles easily (if somewhat lengthily) under NEXTSTEP. If you have support for the new macros on your system, you can build the preformatted versions of the man pages for yourself, and change the "install" and "clean" targets in the Makefiles. (Although if the man pages that get installed look OK to you, it's probably not worth the bother.) +-----------------------+ | RELATED DOCUMENTATION | +-----------------------+ There are other files you should read. Rooted in this directory are: READ_ME The main sendmail README file. src/READ_ME Details on compiling and installing sendmail. cf/README Details on configuring sendmail. cf/README.NeXT Configuration details specific to this distribution. doc/op/op.ps The sendmail Installation & Operations Guide in PostScript format. LEGAL.NeXT Legal notices for included materials.