- •Table of Contents
- •Dedication
- •Foreword
- •Introduction
- •What Is FreeBSD?
- •How Did FreeBSD Get Here?
- •The BSD License: BSD Goes Public
- •The Birth of Modern FreeBSD
- •FreeBSD Development
- •Committers
- •Contributors
- •Users
- •Other BSDs
- •NetBSD
- •OpenBSD
- •Other UNIXes
- •Solaris
- •Linux
- •IRIX, HPUX, etc.
- •FreeBSD's Strengths
- •Portability
- •Power
- •Simplified Software Management
- •Optimized Upgrade Process
- •Filesystem
- •Who Should Use FreeBSD
- •FreeBSD as Your Desktop
- •Who Should Run Another BSD
- •Who Should Run a Proprietary Operating System
- •How to Read This Book
- •What Must You Know?
- •How to Think About UNIX
- •Channels of Communication
- •Working with Channels
- •The Command Line
- •Chapter 1: Installation
- •FreeBSD Hardware
- •Processor
- •Memory (RAM)
- •Hard Drives
- •Downloading FreeBSD
- •Installing by FTP
- •Other FTP Install Information
- •Hardware Setup
- •Actually Installing FreeBSD
- •Configuring the Kernel for ISA Cards
- •Sysinstall: The Ugly FreeBSD Installer
- •Disk Usage
- •Partitioning
- •Root
- •Swap Space
- •Swap Splitting
- •/var, /usr, and /home
- •A Second Hard Drive
- •Soft Updates
- •Block Size
- •What to Install
- •Installation Media
- •Committing
- •Root Password
- •Adding Users
- •Time Zone
- •Mouse
- •Configuring Network Cards
- •Xfree86
- •Software
- •Restart
- •A Note on Editors
- •Chapter 2: Getting More Help
- •Why Not Mail First?
- •The FreeBSD Attitude
- •Man Pages
- •The FreeBSD Manual
- •Man Page Headings
- •The FreeBSD Documentation
- •The Mailing List Archives
- •Other Web Sites
- •Checking the Handbook/FAQ
- •Checking the Man Pages
- •Checking the Mailing List Archives
- •Using Your Answer
- •Mailing for Help
- •Chapter 3: Read This Before You Break Something Else! (Backup and Recovery)
- •Overview
- •System Backups
- •Tape Devices
- •How to Read Dmesg.boot
- •Controlling Your Tape Drive
- •Device Nodes
- •Using the TAPE Variable
- •The mt Command
- •Backup Programs
- •Dump/Restore
- •Restoring from an Archive
- •Checking the Contents of an Archive
- •Extracting Data from an Archive
- •Restoring Interactively
- •Recording What Happened
- •Revision Control
- •Getting Older Versions
- •Breaking Locks
- •Viewing Log Messages
- •Reviewing a File's Revision History
- •Ident and ident Strings
- •Going Further
- •The Fixit Disk
- •Chapter 4: Kernel Games
- •Overview
- •What Is the Kernel?
- •Configuring Your Kernel
- •Sysctl
- •Changing Sysctls
- •Setting Sysctls at Boot
- •Kernel Configuration with Loader.conf
- •Manually Configuring the Loader
- •Viewing Loaded Modules
- •Loading and Unloading Modules
- •Customizing the Kernel
- •Preparation
- •Your Backup Kernel
- •Editing Kernel Files
- •Basic Options
- •Multiple Processors
- •Device Entries
- •Building Your Kernel
- •Troubleshooting Kernel Builds
- •Booting an Alternate Kernel
- •Adding to the Kernel
- •LINT
- •Fixing Errors with Options
- •Tweaking Kernel Performance
- •Sharing Kernels
- •Chapter 5: Networking
- •Overview
- •Network Layers
- •The Physical Layer
- •The Physical Protocol Layer
- •The Logical Protocol Layer
- •The Application Layer
- •The Network in Practice
- •Mbufs
- •What Is a Bit?
- •Ethernet
- •Broadcasting
- •Address Resolution
- •Hubs and Switches
- •Netmasks
- •Netmask Tricks
- •Hexadecimal Netmasks
- •Unusable IP Addresses
- •Routing
- •Network Ports
- •Connecting to an Ethernet Network
- •Multiple IP Addresses on One Interface
- •Using Netstat
- •Chapter 6: Upgrading FreeBSD
- •Overview
- •FreeBSD Versions
- •Release
- •Snapshots
- •Security Updates
- •Which Release Should You Use?
- •Upgrade Methods
- •Upgrading via Sysinstall
- •Upgrading via CVSup
- •Simplifying the CVSup Upgrade Process
- •Building a Local CVSup Server
- •Controlling Access
- •Authentication
- •Combining Authentication and Access
- •Chapter 7: Securing Your System
- •Overview
- •Who Is the Enemy?
- •Script Kiddies
- •Disaffected Users
- •Skilled Attackers
- •FreeBSD Security Announcements
- •Subscribing
- •What You'll Get
- •Installation Security Profiles
- •Moderate
- •Extreme
- •Root, Groups, and Permissions
- •The root Password
- •Groups of Users
- •Primary Group
- •Some Interesting Default Groups
- •Group Permissions
- •Changing Permissions
- •Changing File Ownership
- •Assigning Permissions
- •File Flags
- •Viewing a File's Flags
- •Setting Flags
- •Securelevels
- •Setting Securelevels
- •Which Securelevel Do You Need?
- •What Won't Securelevel and File Flags Do?
- •Living with Securelevels
- •Programs That Can Be Hacked
- •Putting It All Together
- •Chapter 8: Advanced Security Features
- •Traffic Control
- •Default Accept vs. Default Deny
- •TCP Wrappers
- •Configuring Wrappers
- •Daemon Name
- •The Client List
- •Putting It All Together
- •Packet Filtering
- •IPFilter
- •IPFW
- •Default Accept and Default Deny in Packet Filtering
- •Basic Concepts of Packet Filtering
- •Implementing IPFilter
- •Configuring Your Server to Use Jail
- •Configuring Your Kernel to Use Jail
- •Client Setup
- •Final Jail Setup
- •Starting the Jail
- •Managing Jails
- •Shutting Down a Jail
- •Monitoring System Security
- •If You're Hacked
- •Chapter 9: Too Much Information About /etc
- •Overview
- •Varieties of /etc Files
- •Default Files
- •/etc/defaults/rc.conf
- •/etc/adduser.conf
- •/etc/crontab
- •/etc/dhclient.conf
- •/etc/fstab
- •/etc/hosts.allow
- •/etc/hosts.equiv
- •/etc/hosts.lpd
- •/etc/inetd.conf
- •/etc/locate.rc
- •/etc/login.access
- •/etc/login.conf
- •Specifying Default Environment Settings
- •/etc/mail/mailer.conf
- •/etc/make.conf and /etc/defaults/make.conf
- •/etc/master.passwd
- •/etc/motd
- •/etc/mtree/*
- •/etc/namedb/*
- •/etc/newsyslog.conf
- •/etc/passwd
- •/etc/periodic.conf and /etc/defaults/periodic.conf
- •/etc/printcap
- •Working with Printcap Entries
- •/etc/profile
- •/etc/protocols
- •/etc/rc.conf and /etc/defaults/rc.conf
- •/etc/resolv.conf
- •/etc/security
- •/etc/services
- •/etc/shells
- •/etc/spwd.db
- •/etc/sysctl.conf
- •/etc/syslog.conf
- •Chapter 10: Making Your System Useful
- •Overview
- •Making Software
- •The Pain and Pleasure of Source Code
- •Debugging
- •The Ports and Packages System
- •Ports
- •Finding Software
- •Legal Restrictions
- •Using Packages
- •Installing via FTP
- •What Does a Package Install?
- •Uninstalling Packages
- •Package Information
- •Controlling Pkg_add
- •Package Problems
- •Forcing an Install
- •Using Ports
- •Installing a Port
- •Using Make Install
- •Uninstalling and Reinstalling
- •Cleaning Up with Make Clean
- •Building Packages
- •Changing the Install Path
- •Setting Make Options Permanently
- •Upgrading Ports and Packages
- •Upgrading the Ports Collection
- •Ports Collection Upgrade Issues
- •Checking Software Versions
- •Hints for Upgrading
- •Chapter 11: Advanced Software Management
- •Overview
- •Startup and Shutdown Scripts
- •Typical Startup Script
- •Using Scripts to Manage Running Programs
- •Managing Shared Libraries
- •Ldconfig
- •Running Software from the Wrong OS
- •Recompilation
- •Emulation
- •ABI Implementation
- •Foreign Software Libraries
- •Installing and Enabling Linux Mode
- •Identifying Programs
- •What Is Linux_base?
- •Adding to Linux_base
- •Configuring Linux Shared Libraries
- •Installing Extra Linux Packages as RPMs
- •What Is SMP?
- •Kernel Assumptions
- •FreeBSD 3.0 SMP
- •FreeBSD 5 SMP
- •Using SMP
- •SMP and Upgrades
- •Chapter 12: Finding Hosts With DNS
- •How DNS Works
- •Basic DNS Tools
- •The Host Command
- •Getting Detailed Information with Dig
- •Looking Up Hostnames with Dig
- •More Dig Options
- •Configuring a DNS Client: The Resolver
- •Domain or Search Keywords
- •The Nameserver List
- •DNS Information Sources
- •The Hosts File
- •The Named Daemon
- •Zone Files
- •A Real Sample Zone
- •named.conf
- •/var/named/master/absolutebsd.com
- •Making Changes Work
- •Starting Named at Boottime
- •Checking DNS
- •Named Configuration Errors
- •Named Security
- •Controlling Information Order
- •More About BIND
- •Chapter 13: Managing Small Network Services
- •Bandwidth Control
- •Configuring IPFW
- •Reviewing IPFW Rules
- •Dummynet Queues
- •Directional Traffic Shaping
- •Certificates
- •Create a Request
- •Being Your Own CA
- •Testing SSH
- •Enabling SSH
- •Basics of SSH
- •Creating Keys
- •Confirming SSH Identity
- •SSH Clients
- •Connecting via SSH
- •Configuring SSH
- •System Time
- •Setting the Time Zone
- •Network Time Protocol
- •Ntpdate
- •Ntpd
- •Inetd
- •/etc/inetd.conf
- •Configuring Programs in Inetd
- •Inetd Security
- •Starting Inetd
- •Changing Inetd's Behavior
- •Chapter 14: Email Services
- •Email Overview
- •Where FreeBSD Fits In
- •The Email Protocol
- •Email Programs
- •Who Needs Sendmail?
- •Replacing Sendmail
- •Installing Postfix
- •Pieces of Postfix
- •Configuring Postfix
- •Email Aliases
- •Email Logging
- •Virtual Domains
- •Postfix Commands
- •Finding the Correct Mail Host
- •Undeliverable Mail
- •Installing POP3
- •Testing POP3
- •POP3 Logging
- •POP3 Modes
- •Qpopper Preconfiguration Questions
- •Default Qpopper Configuration
- •APOP Setup
- •Configuring Pop3ssl
- •Qpopper Security
- •Chapter 15: Web and FTP Services
- •Overview
- •How a Web Server Works
- •The Apache Web Server
- •Apache Configuration Files
- •Configuring Apache
- •Controlling Apache
- •Virtual Hosting
- •Tweaking Virtual Hosts
- •.NET on FreeBSD
- •Installing the SSCLI
- •FTP Security
- •The FTP Client
- •The FTP Server
- •Chapter 16: Filsystems and Disks
- •Device Nodes
- •Hard Disks and Partitions
- •The /etc/fstab File
- •Disk Basics
- •The Fast File System
- •Vnodes
- •FFS Mount Types
- •FFS Mount Options
- •What's Mounted Now?
- •Dirty Disks
- •Fsck
- •Mounting and Unmounting Disks
- •Mounting Standard Filesystems
- •Mounting with Options
- •Mounting All Standard Filesystems
- •Mounting at Nonstandard Locations
- •Unmounting
- •Soft Updates
- •Enabling Soft Updates
- •IDE Write Caching and Soft Updates
- •Virtual Memory Directory Caching
- •Mounting Foreign Filesystems
- •Using Foreign Mounts
- •Foreign Filesystem Types
- •Mount Options and Foreign Filesystems
- •Filesystem Permissions
- •Removable Media and /etc/fstab
- •Creating a Floppy
- •Creating an FFS Filesystem
- •The Basics of SCSI
- •SCSI Types
- •SCSI Adapters
- •SCSI Buses
- •Termination and Cabling
- •SCSI IDs and LUNs
- •FreeBSD and SCSI
- •Wiring Down Devices
- •Adding New Hard Disks
- •Creating Slices
- •Creating Partitions
- •Configuring /etc/fstab
- •Installing Existing Files onto New Disks
- •Temporary Mounts
- •Moving Files
- •Stackable Mounts
- •Chapter 17: RAID
- •Hardware vs. Software RAID
- •RAID Levels
- •Software RAID
- •Vinum Disk Components
- •Vinum Plex Types
- •Preparing Vinum Drives
- •Dedicating Partitions to Vinum
- •Configuring Vinum
- •Concatenated Plex
- •Removing Vinum Configuration
- •Striped Volumes
- •Mirrored Volumes
- •Starting Vinum at Boot
- •Other Vinum Commands
- •Replacing a Failed Mirrored Plex
- •Chapter 18: System Performance
- •Overview
- •Computer Resources
- •Disk Input/Output
- •Network Bandwidth
- •CPU and Memory
- •Using Top
- •Memory Usage
- •Swap Space Usage
- •CPU Usage
- •When Swap Goes Bad
- •Paging
- •Swapping
- •Are You Swapping or Paging?
- •Fairness in Benchmarking
- •The Initial Test
- •Using Both CPUs
- •Directory Caching
- •Moving /usr/obj
- •Lessons Learned
- •Chapter 19: Now What's It Doing?
- •Status Mails
- •Forwarding Reports
- •Logging with Syslogd
- •Facilities
- •Levels
- •Syslog.conf
- •Wildcards
- •Rotating Logs with Newsyslog.conf
- •Reporting with SNMP
- •Basics of SNMP
- •MIBs
- •Snmpwalk
- •Specific Snmpwalk Queries
- •Translating Between Numbers and Names
- •Setting Up Snmpd
- •Index Numbers
- •Configuring MRTG
- •Sample mrtg.cfg Entry
- •Testing MRTG
- •Tracking Other System Values
- •Monitoring a Single MIB
- •Customizing MRTG
- •MRTG Index Page
- •Sample MRTG Configurations
- •Chapter 20: System Crashes and Panics
- •What Causes Panics?
- •What Does a Panic Look Like?
- •Responding to a Panic
- •Prerequisites
- •Crash Dump Process
- •The Debugging Kernel
- •kernel.debug
- •Dumpon
- •Savecore
- •Upon a Crash
- •Dumps and Bad Kernels
- •Using the Dump
- •Advanced Kernel Debugging
- •Examining Lines
- •Examining Variables
- •Apparent Gdb Weirdness
- •Results
- •Vmcore and Security
- •Symbols vs. No Symbols
- •Serial Consoles
- •Hardware Serial Console
- •Software Serial Console
- •Changing the Configuration
- •Using a Serial Console
- •Serial Login
- •Emergency Logon Setup
- •Disconnecting the Serial Console
- •Submitting a Problem Report
- •Problem Report System
- •What's in a PR?
- •Filling Out the Form
- •PR Results
- •Chapter 21: Desktop FreeBSD
- •Overview
- •Accessing File Shares
- •Prerequisites
- •Character Sets
- •Kernel Support for CIFS
- •SMB Tools
- •Configuring CIFS
- •Minimum Configuration: Name Resolution
- •Other smbutil Functions
- •Mounting a Share
- •Other mount_smbfs Options
- •Sample nsmb.conf Entries
- •CIFS File Ownership
- •Serving Windows File Shares
- •Accessing Print Servers
- •Running a Local Lpd
- •Printer Testing
- •Local Printers
- •X: A Graphic Interface
- •X Prerequisites
- •X Versions
- •Configuring X
- •Making X Look Decent
- •Desktop Applications
- •Web Browsers
- •Email Readers
- •Office Suites
- •Music
- •Graphics
- •Desk Utilities
- •Games
- •Afterword
- •Overview
- •The Community
- •What Can You Do?
- •Getting Things Done
- •Second Opinions
- •Appendix: Some Useful SYSCTL MIBs
- •List of Figures
- •Chapter 1: Installation
- •Chapter 5: Networking
- •Chapter 6: Upgrading FreeBSD
- •Chapter 19: Now What's It Doing?
- •List of Tables
- •Chapter 4: Kernel Games
- •Chapter 5: Networking
- •Chapter 8: Advanced Security Features
- •Chapter 9: Too Much Information About /etc
- •List of Sidebars
- •Chapter 15: Web and FTP Services
Maint: gnome@FreeBSD.org Index: misc
B−deps: gettext−0.10.35 glib−1.2.10_3 gmake−3.79.1 R−deps: gettext−0.10.35 glib−1.2.10_3
#
...............................................................................................
Aha! Midnight Commander can be found under ? /usr/ports/misc/mc.
Other Ways to Browse the Ports Collection
If you prefer working with a Web browser, you can build an HTML index. Just go to /usr/ports and, as root, type make readmes to generate a file (README.html) with the contents of your ports tree. (You can click through various categories, and even view detailed descriptions of each port.)
I f n o n e o f t h e s e o p t i o n s w o r k , t r y t h e F r e e B S D P o r t s T r e e s e a r c h s e r v i c e a t http://www.FreeBSD.org/cgi/ports.cgi.
Between the Web browser and the search engine, you should be able to find a piece of software to meet your needs.
Legal Restrictions
While most of the software in the ports collection is free for noncommercial use, some of it includes unusual legal restrictions. The /usr/ports/LEGAL file lists legal restrictions on various pieces of software. The most common restriction is a prohibition on redistribution; the FreeBSD Project does not include such software in its CD−ROM distributions, just instructions on how to build it. For example, for a long time FreeBSD did not have a Java license. The Project was not allowed to distribute the Java source code or compiled binaries. They could distribute instructions on how to build the source code, however. You could go to a Sun Microsystems Web page, download the Java source, and build your own version of Java on FreeBSD.
Similarly, some pieces of software prohibit commercial use or embedding in commercial products. A few cannot be exported from the United States, thanks to International Traffic in Arms Regulations (ITAR)—they contain cryptography and are classified as "munitions."[2] If you're building FreeBSD systems for redistribution, export, or commercial use, you'll definitely want to chck this file.
Fortunately, the software required for providing network services is free for either commercial or noncommercial use. These restricted packages are the exception, not the rule.
[2]Most of this software is available from non−US sourecs, and can be downloaded anywhere in the word. The official FreeBSD CD−ROM' images are generated in the United States, however.
Using Packages
Packages are precompiled software for a particular version of FreeBSD. We're going to discuss using packages first, as they're generally easier and faster to use than ports. Once you have a grip on packages, we'll go on to ports.
Unless a piece of software has legal restrictions against being distributed in compiled form, it's available as a package. Other software (such as Microsoft Word[3]) is only available in precompiled form. Packages are available on CD−ROM and via FTP.
229
Installing software as a package can save you a great deal of time because you don't have to spend your time compiling from source. To install a package, find its name by searching the ports tree, as described earlier.
Installing from CD−ROM
If you have a FreeBSD CD−ROM set, you already have a fairly extensive collection of compiled packages. To use them, all you need to do is mount the CD and read the package file.
We'll discuss mounting and unmounting media in detail in Chapter 16, but here are the basics.
Put your CD in its drive, become root, and type this command:
...............................................................................................
# mount −t cd9660 /dev/acd0c /cdrom
#
...............................................................................................
The contents of your CD−ROM are now available under /cdrom.
Note You won't be able to eject the CD−ROM while you're using it, or while it's mounted. If you have an idle command prompt sitting on /cdrom, you won't be able to unmount it. To unmount the CD−ROM, enter this command.
...............................................................................................
# umount /cdrom
...............................................................................................
Once you have the CD mounted, look at the packages directory:
...............................................................................................
#cd /cdrom/packages/
#ls
All |
deskutils |
japanese |
tk82 |
|
INDEX |
devel |
java |
python |
tk83 |
Latest |
editors |
kde |
ruby |
tkstep80 |
archivers |
elisp |
korean |
russian |
windowmaker |
astro |
emulators |
lang |
security |
www |
audio |
french |
shells |
x11 |
|
biology |
ftp |
math |
sysutils |
x11−fm |
cad |
games |
mbone |
tcl80 |
x11−fonts |
chinese |
german |
misc |
tcl82 |
x11−toolkits |
comms |
gnome |
net |
tcl83 |
x11−wm |
converters |
graphics |
palm |
textproc |
zope |
databases |
ipv6 |
perl5 |
tk80 |
|
# |
|
|
|
|
...............................................................................................
This should look familiar. Yep, it's the same as the ports tree listing we saw earlier in the chapter. If you go into a directory, however, you'll see something a little different. A single CD−ROM doesn't have nearly enough room to store all the FreeBSD packages, which can be quite large (up to hundreds of megs). You'll find some packages, but not all of them. Many other packages are
230
available on other FreeBSD CD−ROMs. Second, these are files, not directories; they're tarballs containing complete software packages.
For example, in /cdrom/packages/astro we'll see two packages. Both of these are based on ports you'll find in the astro directory of the ports tree.
...............................................................................................
#cd astro/
#ls
openuniverse−1.0.b3.tgz xglobe−0.5.tgz
#
...............................................................................................
To see what a package does, check its description in /usr/ports/INDEX. Search for the package name in the index file, just as we searched for a port name in the index (in the "Finding Software" section, earlier in the chapter). In the fourth field, you'll find a description of the port:
...............................................................................................
# grep −i ^openuniv /usr/ports/INDEX openuniverse−1.0.b3|/usr/ports/astro/openuniverse|/usr/X11R6|OpenGL Solar System simulator for X Window System|/usr/ports/astro/openuniverse/pkg− descr|trevor@FreeBSD.org|astro|Mesa−3.4.2_1 XFree86−libraries−4.1.0 freetype2−2.0.4 gettext−0.10.35 gmake−3.79.1 imake−4.1.0 jpeg−6b|Mesa−3.4.2_1 XFree86−libraries− 4.1.0 freetype2−2.0.4 imake−4.1.0 jpeg−6b|http://openuniverse.sourceforge.net/
#
...............................................................................................
The fourth field of this description says that openuniverse is an "OpenGL Solar System simulator for X Window System." A solar system simulator does sound kind of cool, doesn't it? Let's install it! Use pkg_add(1) to install packages:
...............................................................................................
# pkg_add openuniverse−1.0.b3.tgz
#
...............................................................................................
That's it! The software is installed and ready to use. (The installation usually runs silently, though you'll occasionally see messages during a package install. Pay attention to them, and take whatever action they recommend.)
If a package requires other packages, pkg_add(1) should automatically find those packages and install them. The CD sets are designed such that the dependencies are all on one disk whenever possible. However, if a required package is not available, pkg_add will complain about the missing package by name and fail. In that case, find the required package on another disk and install it first, or just install over FTP.
Installing via FTP
Frequently, a package doesn't exist on the CD because the FreeBSD Project has limited space on
231
its CD−ROM sets and can't possibly fit all 6,000−plus packages onto 4 disks! Also, software on CD is built for a particular release of FreeBSD. Having a CD−ROM of packages for version 4.4 won't help you if you're running FreeBSD 4.6.
Too, if you're tracking −stable, the packages on the CD are slightly out of date, and you should grab the latest package from ftp.FreeBSD.org. (You must have a live Internet connection to do this!)
If you know the full package name and version number, you can get the latest package from the FreeBSD FTP site automatically, like so:
...............................................................................................
# pkg_add −r xearth
Fetching ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/packages−4.4−
release/Latest/xearth.tgz... |
Done. |
# |
|
...............................................................................................
The advantage of this is that the system will automatically find the proper FTP location, download the proper version of the package and all dependencies, and install them all. The downside is, you have to have a live Internet connection.
This method is also less secure than installing from CD. While the packages on the CD set have all been inspected and verified to be what they claim to be, the packages on the FTP server could have been tampered with by a malicious hacker. You could be installing Trojan horses, or worse. (This has never happened, mind you, but it is theoretically possible.)
You can also manually download packages from an FTP site of your choice. (We discussed finding a convenient FTP server in Chapter 1.) To do so, find a convenient FTP site and log in to that server. Then, if you're running a −release, go to pub/FreeBSD/release and into the directory for your version of −release. If you're tracking −stable or −current, go to pub/FreeBSD/ports and choose the directory for your −stable or −release.
Once in the appropriate directory, you'll see a directory tree much like that under /usr/ports. Now, just find your package and download it, then install it via the command line:
...............................................................................................
# pkg_add openuniverse−1.0.b3.tgz
#
...............................................................................................
Note This method will not automatically install dependencies. It's most useful for times when you're behind a firewall and must jump through some hoops to download files from the Internet.
What Does a Package Install?
Now that your software is installed, how do you find it on your system? There's no Start menu, after all! Not to worry.
232
For a complete list of what a piece of software has installed, see /var/db/pkg. This directory contains a complete list of every port or package you have installed on the system, and what each set of software contains.
For example, our /var/db/pkg now contains a directory called openuniverse−1.0.b3. If you look in that directory, you'll see the following:
...............................................................................................
# ls /var/db/pkg/openuniverse−1.0.b3/
+COMMENT |
+CONTENTS |
+DESC |
# |
|
|
...............................................................................................
The +COMMENT file is a brief description of the package; +DESC contains a longer description of the package. The interesting file is +CONTENTS, which lists every file installed by the package. This file is quite long, but we'll look at the start of it.
...............................................................................................
# more /var/db/pkg/openuniverse−1.0.3b/+CONTENTS v @name openuniverse−1.0.b3
@cwd w /usr/X11R6 x @pkgdep jpeg−6b @pkgdep Mesa−3.4.1
@comment y ORIGIN:astro/openuniverse z bin/openuniverse
@comment MD5:2a4775c079a589e78cf54be5444316cb share/openuniverse/data/stars.dat
@comment MD5:eee6bb0caf1ae32bc2ff043e7baee17a share/openuniverse/data/messier.dat
@comment MD5:acd357ee82d95121fbf42ba9982f1dd8
...............................................................................................
The first line (v) is, of course, the name. Following that is the directory tree where the package was installed (w) after the cwd keyword. You can see that openuniverse is installed under /usr/X11R6. The pkgdep keywords (x) are other packages that this package depends on. The ORIGIN comment (y) is the category in the ports tree where this package was created.
Finally you have the list of files (z). Each file installed by this program is listed here, along with its MD5 checksum. (The various package−handling tools use the MD5 checksum to verify that a file is still good and that it hasn't been damaged during transit or by operator error.)
Each file is listed relative to the directory tree given in the packing list. For example, the file bin/openuniverse was actually installed under /usr/X11R6, giving us /usr/X11R6/bin/openuniverse. Similarly, various files are listed as being in share/openuniverse, which is under /usr/X11R6, giving us the real directory of /usr/X11R6/share/openuniverse. Most files installed in a share directory are either documentation or program data. You can read the documentation, or just run openuniverse and see what happens.
(Much of this information on files and directories is also available through pkg_info(1), but it's frequently easier to just look for yourself.)
233