- •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
Debugging
Generally speaking, if you can build a program from source, it will run on your UNIX; if you cannot, the program will not run. When you have the source code, however, a sufficiently experienced sysadmin can learn why a program won't build or run. In many cases, the problem is simple and can be fixed with minimal effort. (This is one reason why access to source code is important.)
Back when every UNIX administrator was a programmer, this debugging absorbed a major portion of the admin's time. Every UNIX was slightly different, so all systems administrators had to understand the platform a program had been written for, and its differences from their platform, before they could hope to get a chunk of code to run. The duplication of effort was truly monstrous.
Slowly, tools such as autoconf and configure were created to help address these cross−platform issues. Still, not every program used these tools, and when they broke, the administrator returned to square one. Systems administrators had to edit source code and Makefiles just to have a chance of making programs work.
[1]It is possible to build software on a foreign platform via something called "cross−compiling." Cross−compiling demands you know much more about building software than we want to go into here, though.
The Ports and Packages System
The FreeBSD ports and packages system is a software−building system designed to simplify the configuration and installation of software. It started addressing program−building issues back in 1995.
Ports are instructions for compiling software on FreeBSD, and packages are simply precompiled ports. Packages install more quickly, and can save you time. Ports install more slowly, but will accept changes from your environment (changes you specify in /etc/make.conf).
The basic idea behind the ports and packages system is very simple: If software must be modified to run on BSD, then the modifications should be automated. If you're going to automate the changes, you might as well record what the program includes so you can easily install and uninstall it. And since you have a software−building process that produces exactly the same result each time, and you've recorded everything that the program−building process creates, you can copy the binaries and install them on any similar FreeBSD system. This is the basis of the ports and packages system.
The whole system is called the ports collection, the ports tree, or even just ports. When someone uses one of these terms, he's generally including the ports, the system for building ports, and packages.
Ports
A port is a set of instructions on how to apply fixes to, or patch, a set of sourcecode files. By combining patches with installation instructions, FreeBSD can maintain a complete record of everything the software−install process has done. This frees you from struggling to install a program, and allows you to concentrate on making the program work properly instead.
If you followed the installation hints in Chapter 1, you installed the ports tree in /usr/ports, something like the following listing:
225
...............................................................................................
# ls /usr/ports/ |
|
|
|
|
INDEX |
cad |
games |
misc |
ukrainian |
LEGAL |
chinese |
german |
net |
vietnamese |
Makefile |
comms |
graphics |
news |
www |
Mk |
converters |
hebrew |
palm |
x11 |
README |
databases |
irc |
picobsd |
x11−clocks |
Templates |
deskutils |
japanese |
x11−fm |
|
Tools |
devel |
java |
russian |
x11−fonts |
archivers |
distfiles |
korean |
science |
x11−servers |
astro |
editors |
lang |
security |
x11−toolkits |
audio |
emulators |
shells |
x11−wm |
|
benchmarks |
french |
math |
sysutils |
|
biology |
ftp |
mbone |
textproc |
|
# |
|
|
|
|
...............................................................................................
If you don't see something like this listing in usr/ports, you need to install the ports to continue. To do so, visit your nearest FTP FreeBSD server, and check the directory for the FreeBSD version you're running; you'll find a directory called ports. Look for two files, ports.tgz and install.sh; download both and run install.sh. When you've finished, you should see something like the previous listing.
The directories shown in the previous list are software categories. Each category contains a further layer of directories, and each directory under a category is a port of a piece of software. Since FreeBSD has almost 6,000 ports as I write this, this directory tree is vital to keeping them in any sort of order!
The following listing shows the contents of the "astro" ports category, where astronomical software supported by FreeBSD is kept. (Yes, people use FreeBSD for serious astronomical work.) This category might not be of much interest to most people, but it has the serious advantage of being small enough to print in a book. Some ports categories, such as "www", have hundreds of entries.
...............................................................................................
#ls /usr/ports/astro/ |
|
|
Makefile |
p5−Astro−SunTime |
sunclock |
SETIsupport |
p5−Astro−Sunrise |
tkseti |
dgpsip |
p5−GPS |
wmglobe |
ephem |
p5−Geo−METAR |
wmmoonclock |
fooseti |
pkg |
wmspaceweather |
gkrellmearth |
pyweather |
wmsun |
gkrellmoon |
rmap |
x3arth |
glunarclock |
saoimage |
xearth |
jday |
sattrack |
xephem |
ksetiwatch |
seti_applet |
xglobe |
luna |
setiathome |
xphoon |
openuniverse |
sscalc |
xplanet |
p5−Astro−MoonPhase |
stars |
xtide |
# |
|
|
...............................................................................................
226
Finding Software
Some of the categories have hundreds of ports, so how can you ever find anything? For an index of ports, see /usr/ports/INDEX, which contains a list of all the ports, in alphabetical order. Each port is described on a single line, with fields separated by pipe symbols (|).
While this is a convenient format for the various system tools to access, it's not particularly human−readable. For you to start reading the index file, you need to know what each field means. (Some of the fields appear redundant, but they're needed for reasons we'll get to later.) Here's a sample entry, with a line break at each delimiter to make it easier to understand:
...............................................................................................
vfooseti−0.6.5|
w/usr/ports/astro/fooseti|
x/usr/local|
yGTK+ frontend to SETI@Home|
z/usr/ports/astro/fooseti/pkg−descr| { petef@databits.net|
| astro|
} XFree86−3.3.6_9 gettext−0.10.35 glib−1.2.10_3 gtk−1.2.10_2| ~ XFree86−3.3.6_9 gettext−0.10.35 glib−1.2.10_3 gtk−1.2.10_2|
• http://www−personal.engin.umich.edu/~agorski/fooseti
...............................................................................................
The first field (v) is the name and version number of the software package—in this case, fooseti version 0.6.5. The second field (w) is the directory where the port can be found (/usr/ports/astro/fooseti), and the next (x) is the default installation location. The fooseti port, for example, installs under /usr/local unless the administrator chooses a separate location. Following is a short description of the software package (y).
The fifth field (z) gives the location of a file, with a more complete description of the software. The email address field ({) lists the software's FreeBSD maintainer, someone who has assumed responsibility for making sure the port works properly. Next is the category (|), the directory under /usr/ports where the port directory lives.
Field eight (}) contains the list of ports needed to build this software. Many ports require other ports as prerequisites; for example, a piece of software might require a special version of make to build, called a build dependency. This example needs XFree86, gettext, glib, and gtk.
The ninth field (~)lists the ports needed to run this software. Many ports have such runtime dependencies in addition to the build dependencies, meaning that when the program runs, it tries to call other programs. If the program's dependencies are not found, the program cannot run. Our example has identical buildtime and runtime dependencies, though this is not always the case.
Last is the URL of the program's home page (•).
Note If you forget what each field means, make print−index will print out a much longer, but prettier, list of everything in the index.
227
Finding by Name
Knowing what the index contains is nice, but how can it help you find a piece of software?
Well, if you know the exact name of the software package, you can use a simple grep command to pick it out. This is quick and easy, but it only works if you're comfortable with grep(1) and you know the exact name of the software in the FreeBSD ports tree. For example, to find staroffice you might enter this grep command:
...............................................................................................
# grep −i ^staroffice INDEX staroffice−5.1a|/usr/ports/editors/staroffice5|/usr/local|Integrated wordprocessor/dbase/spreadheet/drawing/chart/browser|/usr/ports/editors/staroffice5/ pkg−descr|mb@imp.ch|editors linux|unzip−5.42|linux_base−6.1| staroffice−5.2|/usr/ports/editors/staroffice52|/usr/local|Integrated wordprocessor/dbase/spreadheet/drawing/chart/browser|/usr/ports/editors/staroffice52 /pkg−descr|mb@imp.ch|editors linux|linux_base−6.1||
#
...............................................................................................
This output shows us that we have two different versions of staroffice available, version 5.1a and version 5.2. Both are available under /usr/ports/editors, in staroffice5 and staroffice52, respectively.
Finding by Partial Name
If you don't know the software's exact name, try the ports collection's search feature. The make search command scans the ports index for you, searching either for the name of a port or ports where a word appears.
For example, if you're looking for the popular Midnight Commander file manager, you might try this command:
...............................................................................................
# make search name=midnight
#
...............................................................................................
Well, that was less than helpful.
Finding by Keyword
If that search doesn't work, as in the preceding example, you can try a more generic search using the key option. This search scans more fields, returning more hits. (Though if you're searching for a common word, the key search can provide far too much information.)
Here's how to use the key search on the word "midnight":
...............................................................................................
# make search key=midnight
Port: mc−4.5.54_2
Path: ? /usr/ports/misc/mc
Info: Midnight Commander, a free Norton Commander Clone
228