aboutsummaryrefslogtreecommitdiff
path: root/FAQ/admin.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'FAQ/admin.sgml')
-rw-r--r--FAQ/admin.sgml902
1 files changed, 0 insertions, 902 deletions
diff --git a/FAQ/admin.sgml b/FAQ/admin.sgml
deleted file mode 100644
index 816ef54f37..0000000000
--- a/FAQ/admin.sgml
+++ /dev/null
@@ -1,902 +0,0 @@
-<!-- $Id: admin.sgml,v 1.12 1998-12-05 00:24:11 dwhite Exp $ -->
-<!-- The FreeBSD Documentation Project -->
-
- <sect>
- <heading>System Administration<label id="admin"></heading>
-
- <sect1>
- <heading>Where are the system start-up configuration files?</heading>
-
- <p>From 2.0.5R to 2.2.1R, the primary configuration file is
- <tt>/etc/sysconfig</tt>. All the options are to be specified in
- this file and other files such as <htmlurl
- url="http://www.freebsd.org/cgi/man.cgi?rc" name="/etc/rc"> and
- <tt>/etc/netstart</tt> just include it.
-
- <p>Look in the <tt>/etc/sysconfig</tt> file and change the value to
- match your system. This file is filled with comments to show what
- to put in there.
-
- <p>In post-2.2.1 and 3.0, <tt>/etc/sysconfig</tt> was renamed
- to a more self-describing <htmlurl
- url="http://www.freebsd.org/cgi/man.cgi?rc.conf(5)" name="rc.conf">
- file and the syntax cleaned up a bit in the process.
- <tt>/etc/netstart</tt> was also renamed to <tt>/etc/rc.network</tt>
- so that all files could be copied with a <tt><htmlurl
- url="http://www.freebsd.org/cgi/man.cgi?cp" name="cp"> /usr/src/etc/rc*
- /etc</tt> command.
-
- <p><tt>/etc/rc.local</tt> is here as always and may be used to
- start up additional local services like <htmlurl
- url="http://www.freebsd.org/cgi/ports.cgi?^inn" name="INN">
- or set custom options.
-
- <p>The <tt>/etc/rc.serial</tt> is for serial port initialization
- (e.g. locking the port characteristics, and so on.).
-
- <p>The <tt>/etc/rc.i386</tt> is for Intel-specifics settings, such
- as iBCS2 emulation or the PC system console configuration.
-
- <p>Starting with 2.1.0R, you can also have "local" startup files in a
- directory specified in <tt>/etc/sysconfig</tt> (or
- <tt>/etc/rc.conf</tt>):
-
- <verb>
- # Location of local startup files.
- local_startup=/usr/local/etc/rc.local.d
- </verb>
-
- <p>Each file ending in <tt/.sh/ will be executed in alphabetical order.
-
- <p>If you want to ensure a certain execution order without changing all
- the file names, you can use a scheme similar to the following with
- digits prepended to each file name to insure the ordering:
-
- <verb>
- 10news.sh
- 15httpd.sh
- 20ssh.sh
- </verb>
-
- <p>It can be seen as ugly (or SysV :-)) but it provides a simple and
- regular scheme for locally-added packages without resorting to
- magical editing of <tt>/etc/rc.local</tt>. Many of the ports/packages
- assume that <tt>/usr/local/etc/rc.d</tt> is a local startup directory.
-
- <sect1>
- <heading>How do I add a user easily?</heading>
-
- <p>Use the <htmlurl url="http://www.freebsd.org/cgi/man.cgi?adduser"
- name="adduser"> command.
-
- <p>There is another package called ``<tt/new-account/'' also written
- in Perl by Ollivier Robert. Ask <tt>&lt;roberto@FreeBSD.ORG&gt;</tt>
- about it. It is currently undergoing further development.
-
- <p>To remove the user again, use the <htmlurl
- url="http://www.freebsd.org/cgi/man.cgi?rmuser" name="rmuser"> command.
-
- <sect1>
- <heading>How can I add my new hard disk to my FreeBSD system?</heading>
-
- <p>See the Disk Formatting Tutorial at
- <url url="../tutorials/diskformat/"
- name="www.freebsd.org">.
-
- <sect1>
- <heading>I have a new removable drive, how do I use it?</heading>
-
- <p>Whether it's a removable drive like a ZIP or an EZ drive (or
- even a floppy, if you want to use it that way), or a new hard
- disk, once it's installed and recognized by the system, and
- you have your cartridge/floppy/whatever slotted in, things are
- pretty much the same for all devices.
-
- <p><label id="disklabel">(this section is based on <url
- url="http://www.vmunix.com/mark/FreeBSD/ZIP-FAQ.html"
- name="Mark Mayo's ZIP FAQ">)
-
- <p>If it's a ZIP drive or a floppy , you've already got a DOS
- filesystem on it, you can use a command like this:
-
- <verb>
- mount -t msdos /dev/fd0c /floppy
- </verb>
-
- <p>if it's a floppy, or this:
-
- <verb>
- mount -t msdos /dev/sd2s4 /zip
- </verb>
-
- <p>for a ZIP disk with the factory configuration.
-
- <p>For other disks, see how they're laid out using <tt/fdisk/ or
- <tt>/stand/sysinstall</tt>.
-
- <p>The rest of the examples will be for a ZIP drive on sd2, the third
- SCSI disk.
-
- <p>Unless it's a floppy, or a removable you plan on sharing with
- other people, it's probably a better idea to stick a BSD file
- system on it. You'll get long filename support, at least a 2X
- improvement in performance, and a lot more stability. First, you
- need to redo the DOS-level partitions/filesystems. You can either
- use <htmlurl url="http://www.freebsd.org/cgi/man.cgi?fdisk"
- name="fdisk"> or <tt>/stand/sysinstall</tt>, or for a small
- drive that you don't want to bother with multiple operating system
- support on, just blow away the whole FAT partition table (slices)
- and just use the BSD partitioning:
-
- <verb>
- dd if=/dev/zero of=/dev/rsd2 count=2
- disklabel -Brw sd2 auto
- </verb>
-
- <p>You can use disklabel or <tt>/stand/sysinstall</tt> to create multiple
- BSD partitions. You'll certainly want to do this if you're adding
- swap space on a fixed disk, but it's probably irrelevant on a
- removable drive like a ZIP.
-
- <p>Finally, create a new file system, this one's on our ZIP drive
- using the whole disk:
-
- <verb>
- newfs /dev/rsd2c
- </verb>
-
- <p>and mount it:
-
- <verb>
- mount /dev/sd2c /zip
- </verb>
-
- <p>and it's probably a good idea to add a line like this to
- <htmlurl url="http://www.freebsd.org/cgi/man.cgi?fstab"
- name="/etc/fstab"> so you can just type "mount /zip" in the
- future:
-
- <verb>
- /dev/sd2c /zip ffs rw,noauto 0 0
- </verb>
-
- <sect1>
- <heading>How do I mount a secondary DOS partition?</heading>
-
- <p>The secondary DOS partitions are found after ALL the primary
- partitions. For example, if you have an "E" partition as the
- second DOS partition on the second SCSI drive, you need to create
- the special files for "slice 5" in /dev, then mount /dev/sd1s5:
-
- <verb>
- # cd /dev
- # ./MAKEDEV sd1s5
- # mount -t msdos /dev/sd1s5 /dos/e
- </verb>
-
- <sect1>
- <heading>Can I mount other foreign filesystems under FreeBSD?</heading>
-
- <p><bf/ Digital UNIX/ UFS CDROMs can be mounted directly on FreeBSD.
- Mounting disk partitions from Digital UNIX and other systems
- that support UFS may be more complex, depending on the details
- of the disk partitioning for the operating system in question.
-
- <p><bf/ Linux/: 2.2 and later have support for <bf/ext2fs/ partitions.
- See <htmlurl url="http://www.freebsd.org/cgi/man.cgi?mount_ext2fs"
- name="mount_ext2fs"> for more information.
-
- <p>Any other information on this subject would be appreciated.
-
- <sect1>
- <heading>How can I use the NT loader to boot FreeBSD?</heading>
-
- <p>The general idea is that you copy the first sector of your
- native root FreeBSD partition into a file in the DOS/NT
- partition. Assuming you name that file something like
- <tt>c:&bsol;bootsect.bsd</tt> (inspired by <tt>c:&bsol;bootsect.dos</tt>),
- you can then edit the <tt>c:&bsol;boot.ini</tt> file to come up with
- something like this:
-
- <verb>
- [boot loader]
- timeout=30
- default=multi(0)disk(0)rdisk(0)partition(1)\WINDOWS
- [operating systems]
- multi(0)disk(0)rdisk(0)partition(1)\WINDOWS="Windows NT"
- C:\BOOTSECT.BSD="FreeBSD"
- C:\="DOS"
- </verb>
-
- <p>This procedure assumes that DOS, NT, FreeBSD, or whatever
- have been installed into their respective fdisk partitions on the
- <bf/same/ disk. In my case DOS &amp; NT are in the first fdisk
- partition and FreeBSD is in the second. I also installed FreeBSD
- to boot from its native partition, <bf/not/ the disk MBR.
-
- <p>Mount a DOS-formatted floppy (if you've converted to NTFS) or the
- FAT partition, under, say, <tt>/mnt</tt>.
-
- <verb>
- dd if=/dev/rsd0a of=/mnt/bootsect.bsd bs=512 count=1
- </verb>
-
- <p>Reboot into DOS or NT. NTFS users copy the <tt/bootsect.bsd/
- and/or the <tt/bootsect.lnx/ file from the floppy to
- <tt/C:&bsol;/. Modify the attributes (permissions) on
- <tt/boot.ini/ with:
-
- <verb>
- attrib -s -r c:\boot.ini
- </verb>
-
- <p>Edit to add the appropriate entries from the example
- <tt/boot.ini/ above, and restore the attributes:
-
- <verb>
- attrib -r -s c:\boot.ini
- </verb>
-
- <p>If FreeBSD is booting from the MBR, restore it with the DOS
- ``<tt/fdisk/'' command after you reconfigure them to boot from their
- native partitions.
-
- <sect1>
- <heading>
- How do I boot FreeBSD and Linux from LILO?
- </heading>
-
- <p>If you have FreeBSD and Linux on the same disk, just follow
- LILO's installation instructions for booting a non-Linux operating
- system. Very briefly, these are:
-
- <p>Boot Linux, and add the following lines to
- <tt>/etc/lilo.conf</tt>:
- <verb>
- other=/dev/hda2
- table=/dev/hda
- label=FreeBSD
- </verb>
- (the above assumes that your FreeBSD slice is known to Linux as
- <tt>/dev/hda2</tt>; tailor to suit your setup). Then,
- run <tt>lilo</tt> as root and you should be done.
-
- <p>If FreeBSD resides on another disk, you need to add
- ``<tt>loader=/boot/chain.b</tt>'' to the LILO entry.
- For example:
- <verb>
- other=/dev/sdb4
- table=/dev/sdb
- loader=/boot/chain.b
- label=FreeBSD
- </verb>
-
- <p>In some cases you may need to specify the BIOS drive number
- to the FreeBSD boot loader to successfully boot off the second disk.
- For example, if your FreeBSD SCSI disk is probed by BIOS as BIOS
- disk 1, at the FreeBSD boot loader prompt you need to specify:
- <verb>
- Boot: 1:sd(0,a)/kernel
- </verb>
-
- <p>On FreeBSD 2.2.5 and later, you can configure <htmlurl
- url="http://www.freebsd.org/cgi/man.cgi?boot(8)" name="boot(8)">
- to automatically do this for you at boot time.
-
- <p>The <htmlurl
- url="http://sunsite.unc.edu/LDP/HOWTO/mini/Linux+FreeBSD.html"
- name="Linux+FreeBSD mini-HOWTO"> is a good reference for
- FreeBSD and Linux interoperability issues.
-
- <sect1>
- <heading>
- How do I boot FreeBSD and Linux using BootEasy?
- </heading>
-
- <p>Install LILO at the start of your Linux boot partition instead of
- in the Master Boot Record. You can then boot LILO from BootEasy.
-
- <p>If you're running Windows-95 and Linux this is recommended anyway,
- to make it simpler to get Linux booting again if you should need
- to reinstall Windows95 (which is a Jealous Operating System, and
- will bear no other Operating Systems in the Master Boot Record).
-
- <sect1>
- <heading>
- Will a ``dangerously dedicated'' disk endanger my health?
- </heading>
-
- <p><label id="dedicate">The installation procedure allows you to chose
- two different methods in partitioning your harddisk(s). The default way
- makes it compatible with other operating systems on the same machine,
- by using fdisk table entries (called ``slices'' in FreeBSD),
- with a FreeBSD slice that employs partitions of its own.
- Optionally, one can chose to install a boot-selector to switch
- between the possible operating systems on the disk(s).
-
- <p>Now, while this is certainly the common case for people
- coming from a PC background, those people coming more from a
- Unix background and who are going to setup a machine just to
- run FreeBSD and only FreeBSD, are more used to the classic
- Unix way where the operating system owns the entire disks,
- from the very first sector through the end. A true fdisk
- table isn't of any use in this case, the machine is running
- FreeBSD 24 hours per day, 7 days per week, no other operating
- system should ever be booted on it. So, if you select
- ``A)ll FreeBSD'' in sysinstall's fdisk editor, and answer the
- next question with ``No'', you'll get this mode. Note that
- this means the BSD bootstrap also forms the MBR for this drive,
- so there's no space left for anything like a boot manager.
- Don't ever try to install one, or you'll damage the BSD
- bootstrap.
-
- <p>So why it is called ``dangerous''? A disk in this mode
- doesn't contain what normal PC utilities would consider a
- valid fdisk table. Depending on how well they have been
- designed, they might complain at you once they are getting
- in contact with such a disk, or even worse, they might
- damage the BSD bootstrap without even asking or notifying
- you. Some kind of operating system that is in rather
- widespread use on PCs is known for this kind of
- user-unfriendliness (of course, it does this in the name of
- ``user-friendliness''). At least one Award BIOS that is for
- example used in HP Netservers (but not only there) is known
- to ignore any harddisk that doesn't have what it believes to
- be a valid fdisk table. When it comes to booting, it simply
- ignores such a disk drive, advances to the floppy drive, and
- barfs at you with just ``Read error''. Very impressive, eh?
- They probably also call this ``user-friendly'', who knows?
-
- <p>The advantages of this mode are: FreeBSD owns the entire
- disk, no need to waste several fictitious `tracks' for just
- nothing but a 1980-aged simplistic partitioning model
- enforcing some artificial and now rather nonsensical
- constraints on how this partitioning needs to be done.
- These constraints often lead to what might be the biggest
- headaches for OS installations on PCs, geometry mismatch
- hassles resulting out of two different, redundant ways how
- to store the partitioning information in the fdisk table.
- See the chapter about <ref id="missing_os" name="Missing
- Operating System">. In ``dangerously dedicated'' mode, the
- BSD bootstrap starts at sector 0, and this one is the only
- sector that always translates into the same C/H/S values,
- regardless of which `translation' your BIOS is using for
- your disk. Thus, you can also swap disks between
- systems/controllers that use a different translation scheme,
- without risking that they won't boot anymore.
-
- <p>To return a ``dangerously dedicated'' disk for normal PC
- use, there are basically two options. The first is, you
- write enough NULL bytes over the MBR to make any subsequent
- installation believe this to be a blank disk. You can do
- this for example with
-
- <verb>
- dd if=/dev/zero of=/dev/rsd0 count=15
- </verb>
-
- <p>Alternatively, the undocumented DOS ``feature''
-
- <verb>
- fdisk /mbr
- </verb>
-
- <p>will to install a new master boot record as well, thus clobbering the
- BSD bootstrap.
-
- <sect1>
- <heading>How can I add more swap space?</heading>
-
- <p>The best way is to increase the size of your swap partition, or
- take advantage of this convenient excuse to add another disk.
-
- <p>Adding swap onto a separate disk makes things faster than
- simply adding swap onto the same disk. As an example, if you
- are compiling source located on one disk, and the swap is on
- another disk, this is much faster than both swap and compile
- on the same disk. This is true for SCSI disks specifically.
-
- <p> IDE drives are not able to allow access to both drives on
- the same channel at the same time (FreeBSD doesn't support mode 4, so
- all IDE disk I/O is ``programmed''). I would still suggest putting
- your swap on a separate drive however. The drives are so cheap,
- it is not worth worrying about.
-
- <p>It is a really bad idea to locate your swap file over NFS
- unless you are running in a very fast networking environment, with
- a good server.
-
- <p>Here is an example for 64Mb vn-swap (<tt>/usr/swap0</tt>, though
- of course you can use any name that you want).
-
- <p>Make sure your kernel was built with the line
-
- <verb>
- pseudo-device vn 1 #Vnode driver (turns a file into a device)
- </verb>
-
- <p>in your config-file. The GENERIC kernel already contains this.
-
- <enum>
- <item>create a vn-device
-
- <verb>
- cd /dev
- sh ./MAKEDEV vn0
- </verb>
-
- <item>create a swapfile (<tt>/usr/swap0</tt>)
-
- <verb>
- dd if=/dev/zero of=/usr/swap0 bs=1024k count=64
- </verb>
-
- <item>enable the swap file in <tt>/etc/rc.conf</tt>
-
- <verb>
- swapfile="/usr/swap0" # Set to name of swapfile if aux swapfile desired.
- </verb>
-
- <item>reboot the machine
- </enum>
-
- <p>To enable the swap file immediately, type
-
- <verb>
- vnconfig -ce /dev/vn0c /usr/swap0 swap
- </verb>
-
- <sect1>
- <heading>I'm having problems setting up my printer.</heading>
-
- <p>Please have a look at the Handbook entry on printing. It
- should cover most of your problem. See the
- <url url="../handbook/printing.html" name="Handbook entry on printing.">
-
- <sect1>
- <heading>The keyboard mappings are wrong for my system.</heading>
-
- <p>The kbdcontrol program has an option to load a keyboard map file.
- Under <tt>/usr/share/syscons/keymaps</tt> are a number of map
- files. Choose the one relevant to your system and load it.
-
- <verb>
- kbdcontrol -l uk.iso
- </verb>
-
- <p>Both the <tt>/usr/share/syscons/keymaps</tt> and the <tt/.kbd/
- extension are assumed by
- <htmlurl url="http://www.freebsd.org/cgi/man.cgi?kbdcontrol"
- name="kbdcontrol">.
-
- <p>This can be configured in <tt>/etc/sysconfig</tt> (or <htmlurl
- url="http://www.freebsd.org/cgi/man.cgi?rc.conf(5)" name="rc.conf">).
- See the appropriate comments in this file.
-
- <p>In 2.0.5R and later, everything related to text fonts, keyboard
- mapping is in <tt>/usr/share/examples/syscons</tt>.
-
- <p>The following mappings are currently supported:
-
- <itemize>
- <!-- generate by `kbdmap -p' -->
- <item>Belgian ISO-8859-1
- <item>Brazilian 275 keyboard Codepage 850
- <item>Brazilian 275 keyboard ISO-8859-1
- <item>Danish Codepage 865
- <item>Danish ISO-8859-1
- <item>French ISO-8859-1
- <item>German Codepage 850
- <item>German ISO-8859-1
- <item>Italian ISO-8859-1
- <item>Japanese 106
- <item>Japanese 106x
- <item>Latin American
- <item>Norwegian ISO-8859-1
- <item>Polish ISO-8859-2 (programmer's)
- <item>Russian Codepage 866 (alternative)
- <item>Russian koi8-r (shift)
- <item>Russian koi8-r
- <item>Spanish ISO-8859-1
- <item>Swedish Codepage 850
- <item>Swedish ISO-8859-1
- <item>Swiss-German ISO-8859-1
- <item>United Kingdom Codepage 850
- <item>United Kingdom ISO-8859-1
- <item>United States of America ISO-8859-1
- <item>United States of America dvorak
- <item>United States of America dvorakx
- </itemize>
-
- <sect1>
- <heading>I can't get user quotas to work properly.</heading>
-
- <p>
- <enum>
- <item>Don't turn on quotas on '/',
-
- <item>Put the quota file on the file system that the quotas are
- to be enforced on. ie:
-
- <verb>
- FS QUOTA FILE
- /usr /usr/admin/quotas
- /home /home/admin/quotas
- ...
- </verb>
- </enum>
-
- <sect1>
- <heading>What's inappropriate about my ccd?</heading>
-
- <p>The symptom of this is:
-
- <verb>
- # ccdconfig -C
- ccdconfig: ioctl (CCDIOCSET): /dev/ccd0c: Inappropriate file type or format
- #
- </verb>
-
- <p>This usually happens when you are trying to concatenate the
- `c' partitions, which default to type `unused'. The ccd
- driver requires the underlying partition type to be
- FS_BSDFFS. Edit the disklabel of the disks you are trying
- to concatenate and change the types of partitions to
- `4.2BSD'.
-
- <sect1>
- <heading>Why can't I edit the disklabel on my ccd?</heading>
-
- <p>The symptom of this is:
-
- <verb>
- # disklabel ccd0
- (it prints something sensible here, so let's try to edit it)
- # disklabel -e ccd0
- (edit, save, quit)
- disklabel: ioctl DIOCWDINFO: No disk label on disk;
- use "disklabel -r" to install initial label
- #
- </verb>
-
- <p>This is because the disklabel returned by ccd is actually a
- `fake' one that is not really on the disk. You can solve
- this problem by writing it back explicitly, as in:
-
- <verb>
- # disklabel ccd0 > /tmp/disklabel.tmp
- # disklabel -Rr ccd0 /tmp/disklabel.tmp
- # disklabel -e ccd0
- (this will work now)
- </verb>
-
- <sect1>
- <heading>Does FreeBSD support System V IPC primitives?</heading>
-
- <p>Yes, FreeBSD supports System V-style IPC. This includes shared
- memory, messages and semaphores. You need to add the following
- lines to your kernel config to enable them.
-
- <verb>
- options SYSVSHM
- options "SHMMAXPGS=64" # 256Kb of sharable memory
- options SYSVSEM # enable for semaphores
- options SYSVMSG # enable for messaging
- </verb>
-
- <p>Recompile and install.
-
- <p><bf/NOTE:/ You may need to increase SHMMAXPGS to some
- ridiculous number like 4096 (16M!) if you want to run
- GIMP. 256Kb is plenty for X11R6 shared memory.
-
- <sect1>
- <heading>
- How do I use sendmail for mail delivery with UUCP?<label id="uucpmail">
- </heading>
-
- <p>The sendmail configuration that ships with FreeBSD is
- suited for sites that connect directly to the Internet.
- Sites that wish to exchange their mail via UUCP must install
- another sendmail configuration file.
-
- <p>Tweaking <tt>/etc/sendmail.cf</tt> manually is considered
- something for purists. Sendmail version 8 comes with a
- new approach of generating config files via some
- <htmlurl url="http://www.freebsd.org/cgi/man.cgi?m4"
- name="m4"> preprocessing, where the actual hand-crafted configuration
- is on a higher abstraction level. You should use the
- configuration files under
-
- <verb>
- /usr/src/usr.sbin/sendmail/cf
- </verb>
-
- <p>If you didn't install your system with full sources, the sendmail
- config stuff has been broken out into a separate source distribution
- tarball just for you. Assuming you've got your CD-ROM mounted, do:
-
- <verb>
- cd /usr/src
- tar -xvzf /cdrom/dists/src/ssmailcf.aa
- </verb>
-
- <p>Don't panic, this is only a few hundred kilobytes in size.
- The file <tt>README</tt> in the <tt>cf</tt> directory can
- serve as a basic introduction to m4 configuration.
-
- <p>For UUCP delivery, you are best advised to use the
- <em>mailertable</em> feature. This constitutes a database
- that sendmail can use to base its routing decision upon.
-
- <p>First, you have to create your <tt>.mc</tt> file. The
- directory <tt>/usr/src/usr.sbin/sendmail/cf/cf</tt> is the
- home of these files. Look around, there are already a few
- examples. Assuming you have named your file <tt>foo.mc</tt>,
- all you need to do in order to convert it into a valid
- <tt>sendmail.cf</tt> is:
-
- <verb>
- cd /usr/src/usr.sbin/sendmail/cf/cf
- make foo.cf
- cp foo.cf /etc/sendmail.cf
- </verb>
-
- <p>A typical <tt>.mc</tt> file might look like:
-
- <verb>
- include(`../m4/cf.m4')
- VERSIONID(`Your version number')
- OSTYPE(bsd4.4)
-
- FEATURE(nodns)
- FEATURE(nocanonify)
- FEATURE(mailertable)
-
- define(`UUCP_RELAY', your.uucp.relay)
- define(`UUCP_MAX_SIZE', 200000)
-
- MAILER(local)
- MAILER(smtp)
- MAILER(uucp)
-
- Cw your.alias.host.name
- Cw youruucpnodename.UUCP
- </verb>
-
- <p>The <em>nodns</em> and <em>nocanonify</em> features will
- prevent any usage of the DNS during mail delivery. The
- <em>UUCP_RELAY</em> clause is needed for bizarre reasons,
- don't ask. Simply put an Internet hostname there that
- is able to handle .UUCP pseudo-domain addresses; most likely,
- you will enter the mail relay of your ISP there.
-
- <p>Once you've got this, you need this file called
- <tt>/etc/mailertable</tt>. A typical example of this
- gender again:
-
- <verb>
- #
- # makemap hash /etc/mailertable.db < /etc/mailertable
- #
- horus.interface-business.de uucp-dom:horus
- .interface-business.de uucp-dom:if-bus
- interface-business.de uucp-dom:if-bus
- .heep.sax.de smtp8:%1
- horus.UUCP uucp-dom:horus
- if-bus.UUCP uucp-dom:if-bus
- . uucp-dom:sax
- </verb>
-
- <p>As you can see, this is part of a real-life file. The first
- three lines handle special cases where domain-addressed mail
- should not be sent out to the default route, but instead to
- some UUCP neighbor in order to ``shortcut'' the delivery
- path. The next line handles mail to the local Ethernet
- domain that can be delivered using SMTP. Finally, the UUCP
- neighbors are mentioned in the .UUCP pseudo-domain notation,
- to allow for a ``uucp-neighbor!recipient'' override of the
- default rules. The last line is always a single dot, matching
- everything else, with UUCP delivery to a UUCP neighbor that
- serves as your universal mail gateway to the world. All of
- the node names behind the <tt>uucp-dom:</tt> keyword must
- be valid UUCP neighbors, as you can verify using the
- command <tt>uuname</tt>.
-
- <p>As a reminder that this file needs to be converted into a
- DBM database file before being usable, the command line to
- accomplish this is best placed as a comment at the top of
- the mailertable. You always have to execute this command
- each time you change your mailertable.
-
- <p>Final hint: if you are uncertain whether some particular
- mail routing would work, remember the <tt>-bt</tt> option to
- sendmail. It starts sendmail in <em>address test mode</em>;
- simply enter ``0 '', followed by the address you wish to
- test for the mail routing. The last line tells you the used
- internal mail agent, the destination host this agent will be
- called with, and the (possibly translated) address. Leave
- this mode by typing Control-D.
-
- <verb>
- j@uriah 191% sendmail -bt
- ADDRESS TEST MODE (ruleset 3 NOT automatically invoked)
- Enter <ruleset> <address>
- > 0 foo@interface-business.de
- rewrite: ruleset 0 input: foo @ interface-business . de
- ...
- rewrite: ruleset 0 returns: $# uucp-dom $@ if-bus $: foo \
- < @ interface-business . de >
- > ^D
- j@uriah 192%
- </verb>
-
- <sect1>
- <heading>
- How do I set up mail with a dialup connection to the 'net?
- <label id="ispmail">
- </heading>
-
- <p>If you've got a statically assigned IP number, you should not
- need to adjust anything from the default. Set your host name up
- as your assigned internet name and sendmail will do the rest.
-
- <p>If you've got a dynamically assigned IP number and use a dialup
- <bf/ppp/ connection to the internet, you will probably be given a
- mailbox on your ISPs mail server. Lets assume your ISPs domain is
- <tt/myISP.com/, and that your user name is <tt/user/. Lets also
- assume you've called your machine <tt/bsd.home/ and that your ISP
- has told you that you may use <tt/relay.myISP.com/ as a mail relay.
-
- <p>In order to retrieve mail from your mailbox, you'll need to
- install a retrieval agent. <bf/Fetchmail/ is a good choice as it
- supports many different protocols. Usually, POP3 will be provided
- by your ISP. If you've chosen to use user-ppp, you can automatically
- fetch your mail when a connection to the 'net is established with the
- following entry in <tt>/etc/ppp/ppp.linkup</tt>:
-
- <verb>
- MYADDR:
- !bg su user -c fetchmail
- </verb>
-
- <p>I'm assuming that you have an account for <tt/user/ on <tt/bsd.home/.
- In the home directory of <tt/user/ on <tt/bsd.home/, create a
- <tt/.fetchmailrc/ file:
-
- <verb>
- poll myISP.com protocol pop3 fetchall pass MySecret;
- </verb>
-
- <p>Needless to say, this file should not be readable by anyone except
- <tt/user/ as it contains the password <tt/MySecret/.
-
- <p>In order to send mail with the correct <bf/from:/ header, you must
- tell sendmail to use <tt/user@myISP.com/ rather than
- <tt/user@bsd.home/. You may also wish to tell sendmail to send all
- mail via <tt/relay.myISP.com/, allowing quicker mail transmission.
-
- <p>The following <tt/.mc/ file should suffice:
-
- <verb>
- VERSIONID(`bsd.home.mc version 1.0')
- OSTYPE(bsd4.4)dnl
- FEATURE(nouucp)dnl
- MAILER(local)dnl
- MAILER(smtp)dnl
- Cwlocalhost
- Cwbsd.home
- MASQUERADE_AS(`myISP.com')dnl
- FEATURE(allmasquerade)dnl
- FEATURE(masquerade_envelope)dnl
- FEATURE(nocanonify)dnl
- FEATURE(nodns)dnl
- define(SMART_HOST, `relay.myISP.com')
- Dmbsd.home
- define(`confDOMAIN_NAME',`bsd.home')dnl
- define(`confDELIVERY_MODE',`deferred')dnl
- </verb>
-
- <p>Refer to the previous section for details of how to turn this
- <tt/.mc/ file into a <tt/sendmail.cf/ file. Also, don't forget to
- restart sendmail after updating sendmail.cf.
-
- <sect1>
- <heading>Eek! I forgot the root password!</heading>
-
- <p>Don't Panic! Simply restart the system, type -s at the Boot: prompt
- to enter Single User mode. At the question about the shell to use,
- hit ENTER. You'll be dropped to a # prompt. Enter <tt>mount -u /</tt> to
- remount your root filesystem read/write, then run <tt/mount -a/ to
- remount all the filesystems. Run <tt/passwd root/ to
- change the root password then run <tt/exit/
- to continue booting.
-
- <sect1>
- <heading>How do I keep Control-Alt-Delete from rebooting the system?
- </heading>
-
- <p>Edit the keymap you are using for the console and replace the
- <tt/boot/ keywords with <tt/nop/. The default keymap is
- <tt>/usr/share/syscons/keymaps/us.iso.kbd</tt>. You may have to instruct
- <tt>/etc/rc.conf</tt> to load this keymap explicitly for the change to
- take effect. Of course if you are using an alternate keymap for your
- country, you should edit that one instead.
-
- <sect1>
- <heading>How do I reformat DOS text files to UNIX ones?</heading>
-
- <p>Simply use this perl command:
-
-<verb>
-perl -i.bak -pe 's/\r\n/\n/g' file ...
-</verb>
-
- <p>file is the file(s) to process. The modification is done in-place,
- with the original file stored with a .bak extension.
-
- <sect1>
- <heading>How do I kill processes by name?</heading>
-
- <p>Use <url url="/cgi/cvsweb.cgi/man.cgi?killall" name="killall(1)">.
-
- <sect1>
- <heading>Why is su bugging me about not being in root's ACL?
- </heading>
-
- <p>The error comes from the Kerberos distributed authentication system.
- The problem isn't fatal but annoying. You can either run su with the -K
- option, or uninstall Kerberos as described in the next question.
-
- <sect1>
- <heading>How do I uninstall Kerberos?</heading>
-
- <p>To remove Kerberos from the system, reinstall the bin distribution
- for the release you are running. If you have the CDROM, you can
- mount the cd (we'll assume on /cdrom) and run
-
-<verb>
-cd /cdrom/bin
-./install.sh
-</verb>
-
- <sect1>
- <heading>How do I add pseudoterminals to the system?</heading>
-
- <p>If you have lots of telnet, ssh, X, or screen users, you'll probably run
- out of pseudoterminals. Here's how to add more:
-
- <enum>
- <item>Build and install a new kernel with the line
-
- <verb>
- pseudo-device pty 256
- </verb>
-
- <p>in the configuration file.
-
- <item>Run the command
-
- <verb>
- # cd /dev
- # ./MAKEDEV pty{1,2,3,4,5,6,7}
- </verb>
-
- <p>to make 256 device nodes for the new terminals.
-
- <item>Edit <tt>/etc/ttys</tt> and add lines for each of the 256
- terminals. They should match the form of the existing entries, i.e. they look like
-
- <verb>
- ttyqc none network
- </verb>
-
- <p>The order of the letter designations is <tt>tty[pqrsPQRS][0-9a-v]</tt>,
- using a regular expression.
-
- <item>Reboot the system with the new kernel and you're ready to go.
- </enum>
-
-
- </sect>
-