help - help for new users and administrators
This document is meant to familiarize new users and system
with OpenBSD and, if necessary, UNIX in general.
Firstly, a wealth of information is contained within the
pages. In UNIX, the man(1) command is used to view them.
Type man man
for instructions on how to use it properly. Pay especially
to the -k option.
Other OpenBSD references include the FAQ (Frequently Asked
at http://www.openbsd.org/faq, which is mostly intended for administrators
and assumes the reader possesses a working knowledge of UNIX.
There are also mailing lists in place where questions are
OpenBSD developers and other users; see
System administrators should have already read the afterboot(8) man page
which explains a variety of tasks that are typically performed after the
first system boot. When configuring any aspect of the system, first consider
any possible security implications your changes may
The Unix shell [Toc] [Back]
After logging in, some system messages are typically displayed, and then
the user is able to enter commands to be processed by the
The shell is a command-line interpreter that reads user input (normally
from a terminal) and executes commands. There are many different shells
available; OpenBSD ships with csh(1), ksh(1), and sh(1).
shell is indicated by the last field of their corresponding
entry in the
system password file (/etc/passwd).
Basic Unix commands [Toc] [Back]
man Interface to the system manual pages. For any of
listed below, type man <command> for detailed information on what
it does and how to use it.
pwd Print working directory. Files are organized in a
hier(7)) called a tree. This command will indicate
in which directory
you are currently located.
cd Change working directory. Use this command to navigate throughout
the file hierarchy. For example, type cd / to
working directory to the root.
ls List directory contents. Type ls -l for a detailed
cat Although it has many more uses, cat filename will
print the contents
of a plain-text file to the screen.
mkdir Make a directory. For example, mkdir foobar.
rmdir Remove a directory.
rm Remove files. Files are generally only removable by
See the chmod(1) command for information on
chmod Change file modes, including permissions. It is not
obvious how to use this command; please read its
carefully, as proper file permissions, especially on
files, are vital in maintaining security and integrity.
cp Copy files.
mv Move and rename files.
ps List active processes. Most UNIX-based operating
OpenBSD, are multitasking, meaning many programs share
system resources at the same time. A common usage
is ps -auxw,
which will display information about all active processes.
kill Kill processes. Used mostly for terminating runaway/unresponsive
programs, but also used to signal programs for
certain operations (i.e., re-read their configuration).
date Print the current system date and time.
mail Access mailbox.
logout Log out of the system.
When a command is entered, it is first checked to see if it
to the shell. If not, the shell looks for the command in
contained within the PATH environment variable (see environ(7)). If the
command is not found, an error message is printed. Otherwise, the shell
runs the command, passing it any arguments specified on the
man(1), whatis(1), whereis(1), afterboot(8)
This manual page was written by Aaron Campbell <email@example.com> and
first appeared in OpenBSD 2.6.
OpenBSD 3.6 October 17, 1999
[ Back ]