# Fortune (Unix)

fortune is a program that displays a pseudorandom message from a database of quotations. Early versions of the program appeared in Version 7 Unix in 1979. The most common version on modern systems is the BSD fortune, originally written by Ken Arnold. Distributions of fortune are usually bundled with a collection of themed files, containing sayings like those found on fortune cookies (hence the name), quotations from famous people, jokes, or poetry.
fortune is predominantly found on Unix-like systems, but clients for other platforms also exist. Often, users on text-mode Unix terminals will place this command into either their .profile or .logout files to display them at logon and logout, respectively. It is also used to generate text input for certain XScreenSaver modes.

## Content

Most Unix systems use fortunes which are slanted heavily toward the user base of Unix, and thus contain many obscure jokes about computer science and computer programming. Other favoured sources include quotations from science fiction (Star Trek, The Cyberiad, Doctor Who, The Hitchhiker's Guide to the Galaxy, etc.), Zippy the Pinhead, and the writings of Ambrose Bierce and Dave Barry. Most fortune collections also include a wide variety of more conventionally sourced quotations, jokes, and other short passages. A few distributions include "offensive" dicta, which require the -a or -o options to be passed for viewing. These fortunes often include rude humor and profanity, personal attacks, and controversial comments about religion. Sometimes they are provided by another package, however as of FreeBSD 10.0 the offensive dicta have been removed completely. As of November 2017, the quotations (with the exception of tips relevant to system operation) have been removed from FreeBSD entirely after user complaints regarding quotations from Adolf Hitler being contained in some of the files. The exact fortunes vary between each type of Unix, however there seems to be a strong overlap between the FreeBSD and OpenBSD fortune files. The Plan 9 fortune files seem to be much shorter, with many just on 1 line, and the 'offensive' dicta is much stronger. Most Linux distributions, such as Debian (and its derivatives), choose the FreeBSD fortunes to put in their fortune packages, that can be installed through the package manager.

## Purpose

One of the included fortunes, from the "goedel" collection of fortunes about fortune itself, sums up the purpose of the program:
The original fortune program could be used for the more general task of picking up a random line from a plain-text file. However, in most modern Unix systems fortune cannot be used this way, since they use an ad hoc file format for fortune files to allow multiline aphorisms.

## Fortune files

Conventional versions of fortune use two files for each quotation list: a text file with quotations, each separated by the character "%" on its own line, and a random-access data file generated by the strfile(1) program. Alternative implementations, including those made for display on Web pages, typically use only the text file.

## Common options

Several common options exist that change the way command-line versions of fortune behave:
| Option | Action |
| -a | Choose from all databases, regardless of whether they are considered "offensive" or not |
| -e | Make the probability of choosing a fortune file equal to that of all other files |
| -f | Print out a list of all fortune files that would have been searched, but do not print a fortune |
| -i | When used with -m, make regular expression searching case-insensitive |
| -l | Use only quotations longer than the length specified with -n, or 160 characters if -n is not used |
| -m [pattern] | Print all fortunes matching the regular expression specified in [pattern] |
| -n [length] | Override the length used by -l and -s to determine "long" and "short" messages (default 160 characters) |
| -o | Choose only from "offensive" databases |
| -s | Use only quotations shorter than the length specified with -n, or 160 characters if -n is not used |
| -w | Wait for a period of time before terminating; useful for situations in which a fortune needs to be read before the screen is cleared |