INSTALLATION NOTES for OpenBSD/mac68k 2.4 What is OpenBSD? ---------------- OpenBSD is a Berkeley Networking Release 2 (Net/2) and 4.4BSD-Lite -derived Operating System. It is a fully functional UN*X-like system which runs on many architectures and is being ported to more. Continuing the multi-platform tradition, OpenBSD has added ports to mvme68k, powerpc and arc machines. Kernel interfaces have continued to be refined, and now several subsystems and device drivers are shared among the different ports. You can look for this trend to continue. Security of the system as a whole has been significantly improved. Source code for all critical system components has been checked for remote-access, local-access, denial-of-service, data destruction, or information-gathering problems. Tools like ipf, ipnat, and nc have been added to the tree because security conscious people often need them. OpenBSD 2.4 has significantly enhanced the binary emulation subsystem (which includes iBCS2, Linux, OSF/1, SunOS, SVR4, Solaris and Ultrix compatibility) and several kernel subsystems have been generalized to support this more readily. The binary emulation strategy is aimed at making the emulation as accurate as possible. Cryptography components are part of OpenBSD. OpenBSD is from Canada, and export of these pieces (such as kerberosIV) to the world is not restricted. Note that it can not be re-exported from the US once it has entered the US. Because of this, take care NOT to get the distrib- ution from an FTP server in the US if you are outside of Canada and the US. Many new user programs have been added in OpenBSD 2.4, as well, bringing it closer to our goal of supplying a complete and modern UN*X-like environment. Tools like perl and ksh are standard, as are numerous other useful tools. OpenBSD 2.4 is the third release of OpenBSD for Macintosh computers. As always, there is much to be done on this architecture, and help is very much appreciated. However, a wide variety of hardware and software is completely functional making the system an excellent answer to the question of a UN*X-like operating system for the Mac 680x0 line of computers. Sources of OpenBSD: ------------------- This is a list of currently known ftp servers: Korea: ftp://ftp1.kr.openbsd.org/pub/OpenBSD == ftp://sunsite.kren.ne.kr/pub/OpenBSD Australia: ftp://ftp.aba.net.su/pub/OpenBSD == ftp://ftp.au.openbsd.org/pub/OpenBSD France: ftp://ftp.lip6.fr/pub/OpenBSD == ftp://ftp.fr.openbsd.org/pub/OpenBSD ftp://frp.univ-evry.fr/pub/OpenBSD Germany: ftp://ftp.fu-berlin.de/unix/OpenBSD == ftp://ftp.de.openbsd.org/pub/unix/openbsd/mirrors/OpenBSD Japan: ftp://ftp.tut.ac.jp/OpenBSD == ftp://ftp.jp.openbsd.org/OpenBSD ftp://ftp.dti.ad.jp/pub/OpenBSD Sweden: ftp://ftp.stacken.kth.se/pub/OpenBSD == ftp://ftp.se.openbsd.org/pub/OpenBSD ftp://ftp1.se.openbsd.org/pub/OpenBSD Switzerland: ftp://web.eunet.ch/pub/OpenBSD == ftp://ftp.eu.openbsd.org/pub/OpenBSD Thailand: ftp://ftp.ruibon.ac.th/pup/OpenBSD == ftp://ftp.th.openbsd.org/pub/OpenBSD Korea: ftp://sunsite.kren.ne.kr/pup/OpenBSD == ftp://ftp.kr.openbsd.org/pub/OpenBSD United Kingdom: ftp://ftp.demon.co.uk/pub/OpenBSD USA: ftp://freestuff.cs.colorado.edu/pub/OpenBSD == ftp://ftp3.usa.openbsd.org/pub/OpenBSD ftp://openbsd.eecs.umich.edu/pub/OpenBSD == ftp://ftp1.usa.openbsd.org/pub/OpenBSD ftp://ftp4.usa.openbsd.org/pub/OpenBSD ftp://ftp.geek-girl.com/pub/OpenBSD == ftp://ftp.usa.openbsd.org/pub/OpenBSD ftp://ftp6.usa.openbsd.org/pub/OpenBSD ftp://ftp.op.net/pub/OpenBSD ftp://freon.republic.k12.mo.us/pub/OpenBSD frp://ftp.msoe.edu/pub/OpenBSD Canada: ftp://lager.ucs.ualberta.ca/pub/OpenBSD == ftp://ftp.openbsd.org/pub/OpenBSD ftp://ftp.ca.openbsd.org/pub/OpenBSD ftp://ftp1.ca.openbsd.org/pub/OpenBSD ftp://obsd.compmore.net/pub/OpenBSD == ftp://ftp2.ca.openbsd.org/pub/OpenBSD ftp://ftp.styx.org/pub/OpenBSD As well, the file ftp://ftp.openbsd.org/pub/OpenBSD/2.4/ftplist contains a list which is continually updated. If you wish to become a distribution site for OpenBSD, contact deraadt@cvs.openbsd.org. OpenBSD 2.4 Release Contents: ----------------------------- The OpenBSD 2.4 release is organized in the following way. In the .../2.4 directory, for each of the architectures having an OpenBSD 2.4 binary distribution, there is a sub-directory. The mac68k-specific portion of the OpenBSD 2.4 release is found in the "mac68k" subdirectory of the distribution. That subdirectory is laid out as follows: .../2.4/mac68k/ INSTALL.mac68k Installation notes; this file. CKSUM Output of the cksum(1) and md5(1) programs MD5 usable for verification of the correctness of downloaded files. *.tar.gz mac68k binary distribution sets; see below. bsd-generic* mac68k kernel binaries. You MUST install one. utils/ The mac68k installation utilities for MacOS. The OpenBSD/mac68k binary distribution sets contain the binaries which comprise the OpenBSD 2.4 release for mac68k systems. There are ten binary distribution sets. The binary distribution sets can be found in the "mac68k" subdirectory of the OpenBSD 2.4 distribution tree, and are as follows: bsd-generic.tar.gz The OpenBSD/mac68k 2.4 kernel binary. You MUST install this file. It is the kernel that you need to boot the system. [ 1.4M uncompressed ] bsd-genericsbc.tar.gz The OpenBSD/mac68k kernel binary. This is identical in every way to bsd-generic.tar.gz accept that it enables a different SCSI driver which may allow some otherwise incompatible SCSI disks to function with OpenBSD/mac68k. You must install either this or bsd-generic.tar.gz. [ 1.4M uncompressed ] base24 The OpenBSD/mac68k 2.4 base binary distribution. You MUST install this distribution set. It contains the base OpenBSD utilities that are necessary for the system to run and be minimally functional. It includes shared library support, and excludes everything described below. [ 11.9M gzipped, 33.7M uncompressed ] comp24 The OpenBSD/mac68k Compiler tools. All of the tools relating to C, C++, and FORTRAN (yes, there are two!) are supported. This set includes the system include files (/usr/include), the linker, the compiler tool chain, and the various system libraries (except the shared libraries, which are included as part of the base set). This set also includes the manual pages for all of the utilities it contains, as well as the system call and library manual pages. [ 7.0M gzipped, 23.5M uncompressed ] etc24 This distribution set contains the system configuration files that reside in /etc and in several other places. This set MUST be installed if you are installing the system from scratch, but should NOT be used if you are upgrading. (If you are upgrading, it's recommended that you get a copy of this set and CAREFULLY upgrade your configuration files by hand.) [ 93K gzipped, 490K uncompressed ] game24 This set includes the games and their manual pages. [ 2.7M gzipped, 6.7M uncompressed ] man24 This set includes all of the manual pages for the binaries and other software contained in the base set. Note that it does not include any of the manual pages that are included in the other sets. [ 2.4M gzipped, 9.1M uncompressed ] misc24 This set includes the system dictionaries (which are rather large), the typesettable document set, and man pages for other architectures which happen to be installed from the source tree by default. [ 1.7M gzipped, 5.9M uncompressed ] text24 This set includes OpenBSD's text processing tools, including groff, all related programs, and their manual pages. [ 946K gzipped, 3.5M uncompressed ] xbase24 This set includes the base X distribution. This includes programs, headers, libraries, configuration files. xfont24 This set includes all of the X fonts. xserv24 This set includes all of the X servers. The directory '../2.4/mac68k/utils' contains a number of utilities for the MacOS to aid the installation and configuration of OpenBSD. The files in this directory are as follows: Booter1.11.1.sea.hqx This MacOS program is used to load the OpenBSD kernel and start the operating system. In all cases, you will need to download this file. Installer_1.1g.sea.hqx This is the MacOS program used to install downloaded sets (such as those from the bins directory) onto a BSD partition. It is necessary in either the case of a fresh install or an upgrade. Mkfs_1.45.sea.hqx A MacOS program to build BSD filesystems on various partitions you have created (see below). You will need this if you are performing a new installation. OpenBSD System Requirements and Supported Devices: -------------------------------------------------- OpenBSD/mac68k 2.4 runs on several of the older Macintosh computers. 6MB of RAM should be sufficient to boot and the system can probably be squeezed onto a 60MB hard disk by leaving off a package or two. To actually do much compiling or anything more interesting than booting, at least 8MB of RAM and more disk space is recommended. About 80MB will be necessary to install all of the OpenBSD 2.4 binary distribution (note that this does not count swap space!). Much more disk space is required to install the source and objects as well (about another 105MB). OpenBSD/mac68k 2.4 now runs on most 680x0 MacIntosh's. Specifically, it should work on: 68020 with 68851 PMMU and 68881 FPU 68030 with 68882 FPU (most Macs have this) 68040 (not including the 68LC040) The following Macintosh models are "fully" supported. This means that at least the SCSI controller, ADB (keyboard and mouse), and some sort of display will function on these models. On some of these machines, a PMMU and/or FPU are required if they are not provided by default with the machine. Mac II, Mac IIx, Mac IIcx, Mac IIci, Mac SE/30, Mac IIsi, Mac IIvx, Mac IIvi, Performa 600, Centris 650, Color Classic, Classic II, LC520, LC550, Mac LCIII, Performa 4xx, LCII, LCIII, MacTV, Quadra 610, Quadra 650, Quadra 840, Quadra 840AV, Quadra 800, Quadra 700, Duo Series, Powerbook 180 and 180c, PB140, PB145, PB145B, PB160, PB170, PB165, PB165c Supported devices on all of the above systems include: Internal SCSI bus and most SCSI tapes, hard drives, and CD-ROMs Internal sound--enough to beep on some machines, anyway Most NuBus video cards (there have been some problems with some 24-bit color cards) Both internal serial ports ADB keyboards and mice Ethernet cards based on the Natl. Semiconductor 8390 (Asante, Apple, and a few others) Some ethernet cards based on the SONIC chip including internal Ethernet on many of Apple's Quadras. Some systems will boot and are usable from an external terminal (serial tty or SL/IP): LC475, Performa 475, Quadra 605 possibly others What isn't supported, but often asked about: PowerPC-based Macs. Work will begin on this, sometime soon. It will be separate from this port, though. The PowerPC is a much different processor. Machines based on Apple's IOP technology including the Mac IIfx. Machines based on the 68LC040 processor. Unfortunately, the chip itself contains a major bug which is presently being worked on. However, machines such as the Centris 605 don't work right now. Getting the OpenBSD System onto Useful Media: --------------------------------------------- Installation is really only supported from the local Macintosh hard drive or from an AppleShare volume. This means that you'll need at least enough room for the largest file that you will have to install. This is the 6.2M base24 file. There has been talk of allowing an install from split files. If you have the time, desire, and knowledge, please feel free to add that functionality. You will also need to collect the MacOS tools: Mkfs, BSD Install Utility, and BSD/Mac68k Booter. These three are compacted and in binhex form as mkfs.hqx, installer.hqx, and booter.sea.hqx, respectively. Extract them as you would any other Macintosh applications. The source code for these utilities should be in the same directory with the word "src" somewhere in the filename. Preparing your System for OpenBSD Installation: ----------------------------------------------- Find your favorite disk partitioning utility. Some of the ones that have been tried and seem to work are: APS Powertools 2.7.3 SCSI Directory Lite Disk Manager Mac from OnTrack HD SC Setup from Apple I/O Formatter from Diversified (?) Silverlining from LaCie ** First, be sure you have a reliable backup of any data ** which you may want to keep. All information on the hard ** drive you will be repartitioning will be lost. That done, use your favorite partitioning utility to make at least one A/UX "Root & Usr" partition and an A/UX "Swap" partition. The "Root & Usr" partition should be _at least_ 80MB in size if you wish to install all the sets. This partition will be the root partition of your OpenBSD system. Generally, you should allocate twice as much swap space as you have real memory (so, if you have 8MB of RAM, specify 16MB of swap space). Systems that will be heavily used or that are low on real memory should have more swap space allocated. Systems that will be only lightly used can get away with less. If you like, you can also create a smaller root partition and a larger /usr. If you plan to use this machine as a server, you may also want a separate /var. Create these partitions as the BSD "usr" or "User slice X" type. It is also possible to use the Mkfs utility to "convert" partitions from MacOS partitions to BSD partitions. Mkfs will be discussed in more detail later, but it is also very possible to simply prepare your hard drive by partitioning it with MacOS partitions of the correct size. If you do this, simply select the "Convert" button when choosing partitions to build a filesystem on in Mkfs (see below). Before moving on, you should assure that your machine is running the correct software on the MacOS side. In the Memory control panel, you should turn Virtual Memory off whenever you are planning to use the BSD/Mac68k Booter. You should also assure that your machine is using 32-bit addressing. If there is no "Addressing:" option in your Memory control panel and your machine is supported, your probably will need Mode32. Mode32 is a control panel and extension combination which enable 32-bit addressing on older Macs which do not use it by default. This program is available from any Info-Mac mirror. Finally, we recommend strongly that, at least for the purposes of setting the system up, you run with the machine's monitor in 1-bit ("Black and White" in the monitor's control panel) mode. All of that done and accounted for, you are now set to install OpenBSD on your hard drive. Installing the OpenBSD System: ------------------------------ The installation can be broken down into three basic steps: * Running Mkfs to build a filesystem or filesystems. * Running Install Utility to load the files onto your filesystems. * Running the booter to boot the system. **** Preparing the filesystem(s) Double-click on the Mkfs application icon to start it up. It will ask you for the SCSI ID of the drive that you are installing upon. Once this is selected, it will present a list of the partitions on that disk. Select the partition on which you wish to build a filesystem and click on the "Format" button. You will now be asked for a bunch of parameters for the hard drive and the filesystem. Usually, you can just take the defaults. If you are installing onto a Syquest, please see the FAQ. Note that although this dialog only has the "OK" button, you are not committed, yet. Once you get the values you want, press the "OK" button. A dialog will be presented at this point with two options: "Format" and "Cancel." If you choose "Cancel," nothing will be written to your drive. If you choose "Format," the program will proceed to make a filesystem. Mkfs is not a well-behaved MacOS application. It will not allow any other tasks to run while it does (cooperative multitasking at its best). When it's finished, the program will put up a dialog to ask if you have scanned the output for any error messages. Usually there won't have been any errors, but do scan the output to make sure. Simply click on the "I Read It" button and the program will quit. Repeat as necessary for any extra partitions that you wish to make filesystems on. Note that you do _not_ need a filesystem on your swap partition. **** Installing the files Double-click on the Install Utility icon to start it up. The installer will present the same SCSI ID menu that mkfs did. Select the same SCSI ID that you did for mkfs--i.e., the one you are installing onto. If you are installing onto a single root partition, proceed to the "Installation of base files" section, below. If you have not created filesystems for the root, usr, and any other partitions, go back to "Preparing the filesystem(s)," above. When you started the installer, it mounted your root partition. Just before it printed, "Mounting partition 'A' as /," it printed lines like: sd1 at scsi ID 5. This means that the device for scsi ID 5 is sd1. The partitions are signified by a trailing letter. For instance, sd1a would be the root partition of the second scsi disk in the chain, and sd0g would be the first usr partition on the first scsi disk. It is important to emphasize that device numbers after the 'sd' do not correspond to SCSI IDs of disks but rather to logical disks. The lowest SCSI ID will always be sd0 proceeded by increasing ID numbers. You will need to know the proper device to mount the remaining partition(s) by hand: * Select "Build Devices" from the "File" menu. This builds the necessary tree of device files on your filesystem in /dev. * Select "Mini Shell" from the "File" menu. * Mount the filesystems you wish with the command: mount device path For example, if you wish to mount the second partition from the first scsi disk, sd0, on /usr, you would type: mount /dev/sd0b /usr * Type "quit" to exit the minishell after you have mounted all the filesystems. Installation of base files: Select the "Install" menu item from the "File" menu and install base24.tar.gz, bsd-generic.tar.gz, comp24.tar.gz, and any other packages you wish to install at this time (see the contents section for information about what's in each package). The installer will print out the filename of each file as it is installed and will take quite some time to install everything. As is the case with Mkfs, this is not a particularly well-behaved MacOS application and the machine will be completely tied up while the installation takes place. At some point after installing the base package, select the "Build Devices" option from the "File" menu. This will create a bunch of device nodes for you in /dev and your initial /etc/fstab. The installer program also has an option to give you a mini-shell. **** Booting the system Double-click on the BSD/Mac68k Booter icon to start the application. Check that the options in the Booting dialog look sane--especially the SCSI ID. If not, correct them to your preference. When you are satisfied with your choices, try booting OpenBSD. If you wish to save your preferences, choose the "Save Preferences" option in the "File" menu, then quit the application and restart. Due to a long-standing bug, the preferences will not be saved unless you quit. Congratulations, you have successfully installed OpenBSD 2.4. When you reboot into OpenBSD, you should log in as "root" at the login prompt. There is no initial password, but if you're using the machine in a networked environment, you should create yourself an account and protect it and the "root" account with good passwords. You should have got a mail from the install program we recommend you to read. This you can do by running mail and then just enter "1" to get the first message. You quit mail by entering "q". Some of the files in the OpenBSD 2.4 distribution might need to be tailored for your site. We recommend you run: man afterboot which wilk tell you about a bunch of the files needing to be reviewed. If you are unfamiliar with UN*X-like system administration, it's recommended that you buy a book that discusses it. Upgrading a previously-installed OpenBSD System: ------------------------------------------------ To upgrade to OpenBSD 2.4 from a previous version, you should follow the instructions on installing the system beginning with using the MacBSD Install Utility. All you need do is copy each of the distribution sets in over your current system from the MacOS. However, you should not copy the etc24.tar.gz file into the system. Instead, download it while running OpenBSD and put it in /tmp or some other harmless place and unpack it with a command like 'tar zxvf etc24.tar.gz'. You will then have an etc directory with current system configuration files in it. Use this to carefully upgrade your files in the running /etc and reboot the system. Also, it is highly recommended that when upgrading your kernel binary (/bsd) you backup the old, working kernel and extract bsd-generic.tar.gz into / only from OpenBSD. Getting source code for your OpenBSD System: -------------------------------------------- Now that your OpenBSD system is up and running, you probably want to get access to source code so that you can recompile pieces of the system. A few methods are provided. If you have an OpenBSD CD, the source code is provided. Otherwise, you can get the pieces over the Internet using ANONCVS, CTM or FTP. For more information, see http://www.openbsd.org/anoncvs.html http://www.openbsd.org/ctm.html http://www.openbsd.org/ftp.html Using online OpenBSD documentation: ----------------------------------- Documentation is available if you first install the manual distribution set. Traditionally, the UN*X "man pages" (documentation) are denoted by 'name(section)'. Some examples of this are intro(1), man(1), apropos(1), passwd(1), and passwd(5). The section numbers group the topics into several categories, but three are of primary interest: user commands are in section 1, file formats are in section 5, and administrative information is in section 8. The 'man' command is used to view the documentation on a topic, and is started by entering 'man [section] topic'. The brackets [] around the section should not be entered, but rather indicate that the section is optional. If you don't ask for a particular section, the topic with the least-numbered section name will be displayed. For instance, after logging in, enter man passwd to read the documentation for passwd(1). To view the documentation for passwd(5), enter man 5 passwd instead. If you are unsure of what man page you are looking for, enter apropos subject-word where "subject-word" is your topic of interest; a list of possibly related man pages will be displayed. Adding third party software; ``packages'' and ``ports'': ------------------------------------------------------- As complete as your OpenBSD system is, you may want to add any of several excellent third party software applications. There are several ways to do this. You can: 1) Obtain the source code and build the application based upon whatever installation procedures are provided with the application. 2) Use the OpenBSD ``ports'' collection to automatically get any needed source file, apply any required patches, create the application, and install it for you. 3) Use the OpenBSD ``package'' collection to grab a pre-compiled and tested version of the application for your hardware. If you purchased the OpenBSD CD-ROM you already have several popular ``packages'', the ``ports'' collection, and some of the ``ports'' source file releases. NOTE: Some important packages which are not permitted on the CD (due to patents) are available on our FTP servers. In particular, we provide the USA and international versions of both SSH and PGP. The filenames are: ssh-usa-1.2.26.tgz ssh-intl-1.2.26.tgz pgp-usa-2.6.3.tgz pgp-intl-2.6.3.tgz You are STRONGLY urged to install one of the above ssh packages and use ssh instead of telnet, rlogin, or rsh. See below for instructions on installing packages using ftp. Instructions for installing applications from the various sources using the different installation methods follow. If emacs is to be installed it should be installed first as it creates the ``info'' directory file that may be modified by other applications. Installing applications from the CD-ROM package collection: The OpenBSD CD-ROM ships with several applications pre-built for various hardware architectures. The number of applications vary according to available disk space. Check the directory 2.4/packages/mac68k to see which packages are available for your hardware architecture. That directory will be on the same CD-ROM containing the OS installation files for your architecture. To install one or more of these packages you must 1) become the superuser (root) 2) mount the appropriage CD-ROM 3) use the ``pkg_add'' command to install the software Example (in which we use su(1) to get superuser privileges, thus you have to be in group "wheel", see the manual page for su(1)). $ su Password: # mkdir -p /cdrom # mount /dev/cd0a /cdrom # pkg_add /cdrom/2.4/packages/mac68k/ # # umount /cdrom Package names are usually the application name and version with .tgz appended, e.g. emacs-20.3.tgz Installing applications from the ftp.openbsd.org package collection: All available packages for your architecture have been placed on ftp.openbsd.org in the directory pub/OpenBSD/2.4/packages/mac68k/ You may want to peruse this to see what packages are available. The packages are also on the OpenBSD FTP mirror sites. See http://www.openbsd.org/ftp.html for a list of current ftp mirror sites. Installation of a package is very easy. 1) become the superuser (root) 2) use the ``pkg_add'' command to install the software ``pkg_add'' is smart enough to know how to download the software from the OpenBSD ftp server. Example: $ su Password: # pkg_add ftp://ftp.openbsd.org/pub/OpenBSD/2.4/packages/mac68k/emacs-20.3.tgz Note: there are both USA and INTERNATIONAL versions of ssh and pgp on the ftp server. Be sure to grab the correct version. The USA versions, ssh-usa-1.2.26.tgz and pgp-usa-2.6.3.tgz, use RSAREF, a legal requirement for use within the United States due to patent issues. Packages available include (at least): ImageMagick-4.0.6.tgz mpeg_lib-1.2.1.tgz Xaw3d-1.3.tgz netpipes-4.1.1-export.tgz afm-1.0.tgz nmh-0.27.tgz bash-2.02.tgz pgp-intl-2.6.3.tgz bison-1.25.tgz pgp-usa-2.6.3.tgz bzip2-0.9.0b.tgz pine-4.03.tgz dejagnu-1.3.tgz png-1.0.2.tgz emacs-20.3.tgz psutils-a4-1.17.tgz enscript-1.6.1.tgz psutils-letter-1.17.tgz expect-5.26.tgz screen-3.7.4.tgz fetchmail-4.5.4.tgz sharutils-4.2.tgz ghostscript-5.10.tgz ssh-intl-1.2.26.tgz gimp-1.0.0.tgz ssh-usa-1.2.26.tgz glimpse-4.1.tgz tar-1.12.tgz gmake-3.76.1.tgz tcl-8.0.2.tgz gnuplot-3.5.tgz tcsh-6.07.02.tgz gtk+-1.0.5.tgz teTeX-0.4.tgz gv-3.5.8.tgz tiff-3.4.tgz id-utils-3.2.tgz tk-8.0.2.tgz idled-1.16.tgz transfig-3.2.1.tgz iozone-2.01.tgz unzip-5.3.2.tgz ircii-2.8.2-epic3.004.tgz xcolors-1.3.tgz ispell-3.1.20.tgz xfig-3.2.2.tgz jove-4.16.tgz xntp3-5.93-export.tgz jpeg-6b.tgz xpaint-2.5.5.tgz lesstif-0.86.0.tgz xphoon-91.9.18.tgz m4-1.4.tgz xv-3.10a.tgz mm-2.7.tgz Note: these packages may not exist for all architectures; other packages may be added. Some packages are only available via ftp. Installing applications from the CD-ROM ports collection: The CD-ROM ``ports'' collection is a set of Makefiles, patches, and other files used to control the building and installation of an application from source files. The source files come from archives which are also, for the most part, on the OpenBSD CD-ROM. Creating an application from sources can require a lot of disk space, sometimes 50 megabytes or more. The first step is to determine which of your disks has enough room. Once you've made this determination read the file README.ports on CD-ROM 2 to see how to copy or mount the ports directory. To build an application you must: 1) become the superuser (root) 2) mount CD-ROM number 2 on the directory /cdrom. This is necessary to find the application source files. 3) cd to the ports directory containing the port you wish to build. To build samba, for example, where you'd previously copied the ports files into the /usr/ports directory: cd /usr/ports/net/samba 4) make FETCH_SYMLINK_DISTFILES=YES 5) make FETCH_SYMLINK_DISTFILES=YES install 6) make FETCH_SYMLINK_DISTFILES=YES clean The FETCH_SYMLINK_DISTFILES=YES parameter tells make not to copy the application's distribution sources from the cdrom to your hard disk, but instead create a symbolic link pointing to the CD-ROM. This is done to conserve disk space. Installing applications from the OpenBSD ports collection: See http://www.openbsd.org/ports.html for current instructions on obtaining and installing OpenBSD ports. Installing other applications: If an OpenBSD package or port does not exist for an application you're pretty much on your own. The first thing to do is ask ports@openbsd.org if anyone is working on a port -- there may be one in progress. If no luck there you may try the FreeBSD ports or NetBSD package collection. If you are on an i386 based machine it is quite possible that the FreeBSD port, if one exists, will work for you. If you can't find an existing port try to make your own and feed it back to OpenBSD. That's how our ports collection grows. Some details can be found at http://www.openbsd.org/porting.html with more help coming from the mailing list, ports@openbsd.org. Administrivia: -------------- There are various mailing lists available via the mailing list server at . To get help on using the mailing list server, send mail to that address with an empty body, and it will reply with instructions. There are also two OpenBSD Usenet newsgroups, comp.unix.bsd.openbsd.announce for important announcements and comp.unix.bsd.openbsd.misc for general OpenBSD discussion. To report bugs, use the 'sendbug' command shipped with OpenBSD, and fill in as much information about the problem as you can. Good bug reports include lots of details. Additionally, bug reports can be sent by mail to: bugs@OpenBSD.ORG Use of 'sendbug' is encouraged, however, because bugs reported with it are entered into the OpenBSD bugs database, and thus can't slip through the cracks. As a favor, please avoid mailing huge documents or files to the mailing lists. Instead, put the material you would have sent up for FTP somewhere, then mail the appropriate list about it, or, if you'd rather not do that, mail the list saying you'll send the data to those who want it.