xref: /netbsd-src/share/man/man7/hier.7 (revision 87d689fb734c654d2486f87f7be32f1b53ecdbec)
1.\"	$NetBSD: hier.7,v 1.127 2018/01/09 09:22:25 wiz Exp $
2.\"
3.\" Copyright (c) 1990, 1993, 1994
4.\"	The Regents of the University of California.  All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\" 3. Neither the name of the University nor the names of its contributors
15.\"    may be used to endorse or promote products derived from this software
16.\"    without specific prior written permission.
17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28.\" SUCH DAMAGE.
29.\"
30.\"	@(#)hier.7	8.5 (Berkeley) 6/1/94
31.\"
32.Dd January 8, 2018
33.Dt HIER 7
34.Os
35.Sh NAME
36.Nm hier
37.Nd layout of file systems
38.Sh DESCRIPTION
39An outline of the file system hierarchy.
40.Pp
41Naming is very important.
42The
43.Ux
44System relies on filename conventions for much of its power as a system.
45The following file system layout describes generally where things are
46and what they are, with references to other man pages for more detailed
47documentation.
48.Pp
49Not all files will be in every system.
50.Bl -tag -width "/altroot/"
51.It Pa \&/
52Root directory of the system.
53.It Pa /COPYRIGHT
54System copyright notice, most often put on CD-ROM distributions.
55.It Pa "/[a-z]/"
56User file systems.
57.It Pa /altroot/
58Alternate root file system, in case of disaster.
59.\" .It Pa /amd/
60.\" Home directories mount point; see
61.\" .Xr amd 8 .
62.It Pa /bin/
63Utilities used in both single and multi-user environments.
64.It Pa /boot*
65Second-stage boot loader(s) for some platforms; see
66.Xr installboot 8 .
67.It Pa /cdrom/
68Empty directory commonly used by
69system administrators as a temporary mount point for ISO-9660 file
70systems on CD (or DVD) media.
71.It Pa /dev/
72Block, character, and other special device files.
73.Pp
74.Bl -tag -width "MAKEDEV" -compact
75.It Pa MAKEDEV
76Script for creating device files;
77see
78.Xr makedev 8 .
79.It Pa console
80The computer's console device.
81.It Pa drum
82The computer's swap space device; see
83.Xr drum 4 .
84.It Pa fd/
85File descriptor files;
86see
87.Xr fd 4 .
88.It Pa klog
89Kernel logging device; see
90.Xr syslog 3 .
91.It Pa kmem
92Kernel virtual memory device; see
93.Xr mem 4 .
94.It Pa log
95.Ux
96domain datagram log socket; see
97.Xr syslogd 8 .
98.It Pa mem
99Kernel physical memory device; see
100.Xr mem 4 .
101.It Pa null
102The null device; see
103.Xr null 4 .
104.It Pa pts/
105Mount point for the pseudo-terminal device file system; see
106.Xr mount_ptyfs 8 .
107.It Pa stderr
108.It Pa stdin
109.It Pa stdout
110File descriptor files;
111see
112.Xr fd 4 .
113.It Pa tty
114Device pointing to each process's own controlling terminal; see
115.Xr tty 4 .
116.It Pa zero
117The zero device; see
118.Xr zero 4 .
119.El
120.\" .It Pa /dump/
121.\" Online
122.\" .Xr dump 8
123.\" repository.
124.It Pa /etc/
125System configuration files and scripts.
126.Pp
127.Bl -tag -width "master.passwd" -compact
128.It Pa amd*
129Configuration files for
130.Xr amd 8 .
131.It Pa changelist
132Files backed up by the
133.Pa security
134script.
135.It Pa crontab
136Schedule used by the
137.Xr cron 8
138daemon.
139.It Pa csh.cshrc
140.It Pa csh.login
141.It Pa csh.logout
142System-wide scripts for
143.Xr csh 1 .
144.It Pa daily
145Script run each day by
146.Xr cron 8 .
147.It Pa daily.conf
148Configuration file for
149.Pa daily ;
150see
151.Xr daily.conf 5 .
152.It Pa defaults/
153Default configuration files read by various
154.Pa /etc/*.conf
155files.
156.It Pa disktab
157Disk description file; see
158.Xr disktab 5 .
159.It Pa dm.conf
160Dungeon master configuration; see
161.Xr dm.conf 5 .
162.It Pa dumpdates
163Dump history; see
164.Xr dump 8 .
165.It Pa exports
166File system export information; see
167.Xr mountd 8 .
168.It Pa fstab
169File system mounting table; see
170.Xr fstab 5
171and
172.Xr mount 8 .
173.It Pa ftpusers
174Users denied
175.Xr ftp 1
176access; see
177.Xr ftpd 8 .
178.It Pa ftpwelcome
179.Xr ftp 1
180initial message; see
181.Xr ftpd 8 .
182.It Pa gettytab
183Terminal configuration database; see
184.Xr gettytab 5 .
185.It Pa group
186Group permissions file; see
187.Xr group 5 .
188.It Pa hosts
189Host name database backup for
190.Xr named 8 ;
191see
192.Xr hosts 5 .
193.It Pa hosts.equiv
194Trusted machines with equivalent user IDs.
195(Obsolete.)
196.It Pa hosts.lpd
197Trusted machines with printing privileges.
198.It Pa inetd.conf
199Internet server configuration file; see
200.Xr inetd 8 .
201.It Pa kerberosV/
202Configuration files for Kerberos version V;
203see
204.Xr kerberos 8 .
205.It Pa localtime
206Local time zone;
207see
208.Xr ctime 3 .
209.It Pa login.conf
210Configuration of user classes and limits; see
211.Xr login.conf 5 .
212.It Pa mail/
213Configuration files for
214.Xr sendmail 1 .
215.Pp
216.Bl -tag -width "sendmail.*" -compact
217.It Pa aliases*
218Username alias files.
219.It Pa sendmail.*
220.Xr sendmail 1
221configuration information.
222.El
223.It Pa mail.rc
224System-wide initialization script for
225.Xr mail 1 .
226.It Pa man.conf
227Configuration file for
228.Xr man 1 ;
229see
230.Xr man.conf 5 .
231.It Pa master.passwd
232Main password file, readable only by root; see
233.Xr passwd 5 .
234.It Pa mk.conf
235Optional file containing
236.Xr make 1
237variables, used to configure pkgsrc and the system sources.
238.It Pa monthly
239Script run each month by
240.Xr cron 8 .
241.It Pa monthly.conf
242Configuration file for
243.Pa monthly ;
244see
245.Xr monthly.conf 5 .
246.It Pa motd
247System message of the day.
248.It Pa mtree/
249.Xr mtree 8
250configuration files.
251.It Pa named.*
252.It Pa namedb/
253.Xr named 8
254configuration files and databases.
255.It Pa netgroup
256Network groups; see
257.Xr netgroup 5 .
258.It Pa netstart
259Network startup script .
260.It Pa networks
261Network name database; see
262.Xr networks 5 .
263.It Pa passwd
264World readable password file generated from master.passwd; see
265.Xr passwd 5 ,
266.Xr pwd_mkdb 8 .
267.It Pa phones
268Remote host telephone number data base; see
269.Xr phones 5 .
270.It Pa printcap
271Printer configuration for
272.Xr lpr 1 ;
273see
274.Xr printcap 5 .
275.It Pa profile
276System-wide scripts for
277.Xr sh 1 .
278.It Pa protocols
279Protocol name database; see
280.Xr protocols 5 .
281.It Pa pwd.db
282Database form of passwd file; see
283.Xr pwd_mkdb 8 .
284.It Pa rc
285Master system startup script invoked by
286.Xr init 8 ;
287see
288.Xr rc 8 .
289.It Pa rc.conf
290Configuration file for system startup and shutdown scripts; see
291.Xr rc.conf 5 .
292.It Pa rc.d/
293Directory containing per-subsystem startup and shutdown scripts; see
294.Xr rc 8 .
295.It Pa rc.local
296Locally editable system startup script.
297.It Pa rc.shutdown
298Master system shutdown script invoked by
299.Xr shutdown 8 ;
300see
301.Xr rc 8 .
302.It Pa remote
303Remote host description file; see
304.Xr remote 5 .
305.It Pa security
306Daily (in)security script run by
307.Xr cron 8 .
308.It Pa security.conf
309Configuration file for
310.Pa security ;
311see
312.Xr security.conf 5 .
313.It Pa services
314Service name data base; see
315.Xr services 5 .
316.It Pa shells
317List of permitted shells; see
318.Xr shells 5 .
319.It Pa skel/
320Sample initialization files for new user accounts.
321.It Pa sliphome/
322SLIP login/logout scripts; see
323.Xr sliplogin 8 .
324.It Pa spwd.db
325Database form of master.passwd file; see
326.Xr pwd_mkdb 8 .
327.It Pa syslog.conf
328.Xr syslogd 8
329Configuration file; see
330.Xr syslog.conf 5 .
331.It Pa ttyaction
332Login hooks for specific ttys, typically used to chown console
333devices.
334See
335.Xr ttyaction 5 .
336.It Pa ttys
337Terminal initialization information; see
338.Xr ttys 5 .
339.It Pa weekly
340Script run each week by
341.Xr cron 8 .
342.It Pa weekly.conf
343Configuration file for
344.Pa weekly ;
345see
346.Xr weekly.conf 5 .
347.El
348.It Pa /home/
349Default location for user home directories.
350.It Pa /kern/
351Mount point for the kern file system; see
352.Xr mount_kernfs 8 .
353.It Pa /lib/
354Dynamic linked libraries used by dynamically linked programs
355that cannot rely upon
356.Pa /usr/lib/
357being available, such as those in
358.Pa /bin/
359and
360.Pa /sbin/ .
361.It Pa /libdata/
362Non-executable files
363.Pq such as device firmware
364required at boot time, when
365.Pa /usr/libdata
366may not be available.
367.It Pa /libexec/
368System utilities (such as the dynamic linker) required by programs
369and libraries that cannot rely upon
370.Pa /usr/libexec/
371being available.
372.It Pa /mnt/
373Empty directory commonly used by
374system administrators as a temporary mount point.
375.It Pa /net/
376automounted NFS shares;
377see
378.Xr auto_master 5
379.It Pa /netbsd
380Kernel executable image (the operating system loaded into memory
381at boot time).
382.It Pa /proc/
383Mount point for the process file system; see
384.Xr mount_procfs 8 .
385.It Pa /rescue/
386Statically linked rescue tools, for use in system recovery.
387.It Pa /root/
388Home directory for the super-user.
389.Pp
390.Bl -tag -width ".profile" -compact
391.It Pa \&.cshrc
392Super-user start-up file for
393.Xr csh 1 .
394.It Pa \&.login
395super-user start-up file for
396.Xr csh 1 .
397.It Pa \&.profile
398super-user start-up file for
399.Xr sh 1 .
400.It Pa \&.rhosts
401Super-user id mapping between machines.
402(Obsolete.)
403.El
404.It Pa /sbin/
405System programs and administration utilities
406used in both single-user and multi-user environments.
407.It Pa /stand/
408Programs used in a standalone environment, that is, things that run on
409bare hardware without a kernel.
410Currently kernel modules are also placed here, although this remains
411somewhat controversial and they may yet get moved.
412.It Pa /tmp/
413Temporary files.
414The contents of
415.Pa /tmp
416are usually
417.Em not
418preserved across a system reboot.
419.It Pa /usr/
420Contains the majority of the system utilities and files.
421.Pp
422.Bl -tag -width "libdata/" -compact
423.It Pa X11R6/
424X11 files (for X11 revision 6).
425.It Pa X11R7/
426X11 files (for X11 revision 7).
427.Pp
428.Bl -tag -width "include/" -compact
429.It Pa bin/
430X11 binaries.
431.It Pa include/
432X11 include files.
433.It Pa lib/
434X11 libraries.
435.El
436.Pp
437.It Pa bin/
438Common utilities, programming tools, and applications.
439.It Pa games/
440The important stuff.
441.It Pa include/
442Standard C (and extension) include files.
443.Pp
444.Bl -tag -width "protocols/" -compact
445.It Pa arpa/
446Include files for Internet service protocols.
447.It Pa atf/
448Include files for the Automated Testing Framework; see
449.Xr atf 7 .
450.It Pa g++/
451Include files for the GNU C++ compiler.
452.It Pa machine/
453Machine specific include files.
454.It Pa net/
455Miscellaneous network include files.
456.It Pa netatalk/
457C include files for AppleTalk protocols
458see
459.Xr atalk 4 .
460.It Pa netinet/
461Include files for Internet standard protocols; see
462.Xr inet 4 .
463.It Pa netinet6/
464Include files for Internet protocol version 6; see
465.Xr inet6 4 .
466.It Pa netkey/
467Include files for secret key management, used for security protocols; see
468.Xr ipsec 4 .
469.It Pa netnatm/
470C include files for native mode ATM.
471.It Pa nfs/
472C include files for NFS (Network File System).
473.It Pa protocols/
474C include files for Berkeley service protocols.
475.It Pa sys/
476``System-level'' C include files.
477.It Pa ufs/
478C include files for several mutually related file systems.
479(The `u' was originally for
480.Ux . )
481.El
482.Pp
483.It Pa lib/
484Archive, profiled, position independent archive, and shared libraries.
485.Pp
486.Bl -tag -width "lua/" -compact
487.It Pa lua/
488.Bl -tag -width "5.3/" -compact
489.It Pa 5.3/
490Lua 5.3 modules.
491.El
492.El
493.Pp
494.It Pa libdata/
495Miscellaneous utility data files.
496.It Pa libexec/
497System daemons & system utilities (executed by other programs).
498.Pp
499.It Pa mdec/
500Boot blocks, etc.
501.It Pa obj/
502Architecture-specific target tree produced by building the
503.Pa /usr/src
504tree; often a symbolic link or mounted file system.
505.It Pa pkg/
506Installed third-party software packages.
507.Pp
508.Bl -tag -width "include/" -compact
509.It Pa bin/
510Package binaries.
511.It Pa include/
512Package include files.
513.It Pa lib/
514Package libraries.
515.It Pa libdata/
516Package data files.
517.It Pa libexec/
518Package daemons.
519.It Pa sbin/
520Package system utilities.
521.El
522.Pp
523.It Pa pkgsrc/
524Build descriptions (packaging) for the
525.Nx
526package system.
527.Pp
528.Bl -tag -width "distfilesX" -compact
529.It Pa distfiles/
530Downloaded upstream source archives.
531.It Pa packages/
532Compiled binary packages.
533.El
534.Pp
535There are also several other subdirectories which contain packages of
536a certain category, e.g., archivers, graphics, ...
537.Pp
538.It Pa sbin/
539System daemons and system utilities (normally executed by the super-user).
540.It Pa share/
541Architecture-independent files, mostly text.
542.Pp
543.Bl -tag -width "calendar/" -compact
544.It Pa calendar/
545A variety of calendar files; see
546.Xr calendar 1 .
547.It Pa dict/
548Word lists;
549see
550.Xr look 1
551and
552.Xr spell 1 .
553.Pp
554.Bl -tag -width "special/" -compact
555.It Pa words
556Common words.
557.It Pa web2
558Words from Webster's Second International Dictionary.
559.It Pa papers/
560Reference databases;
561see
562.Xr refer 1 .
563.It Pa special/
564Custom word lists;
565see
566.Xr spell 1 .
567.El
568.Pp
569.It Pa doc/
570Miscellaneous documentation.
571.It Pa games/
572Data files used by various games.
573.It Pa i18n/
574internationalization databases; see
575.Xr iconv 3 .
576.It Pa locale/
577Locale databases and gettext message catalogs; see
578.Xr setlocale 3
579and
580.Xr gettext 3 .
581.It Pa man/
582Manual pages.
583.It Pa me/
584Macros for use with the
585.Xr me 7
586roff macro package.
587.It Pa misc/
588Miscellaneous system-wide text files.
589.Pp
590.Bl -tag -width "terminfo.cdb" -compact
591.It Pa terminfo
592Terminal characteristics database;
593see
594.Xr terminfo 5 .
595.It Pa terminfo.cdb
596database form of terminfo file; see
597.Xr tic 1 .
598.El
599.Pp
600.It Pa mk/
601Include files for
602.Xr make 1 .
603.It Pa ms/
604Macros for use with the
605.Xr ms 7
606roff macro package.
607.It Pa nls/
608Message catalogs; see
609.Xr catgets 3 .
610.It Pa tmac/
611Text processing macros;
612see
613.Xr nroff 1
614and
615.Xr troff 1 .
616.It Pa zoneinfo/
617Time zone database;
618see
619.Xr tzfile 5 .
620.El
621.It Pa tests/
622Test programs; see
623.Xr tests 7
624for information on how to run them.
625.El
626.It Pa /usr/src/
627.Nx
628and local source files.
629.Pp
630.Bl -tag -width "domestic/" -compact
631.It Pa bin/
632Source for utilities/files in
633.Pa /bin .
634.It Pa common/
635Sources shared between kernel and userland.
636.It Pa crypto/
637Cryptographic source, which may have import or export restrictions.
638.It Pa dist/
639Third-party
640.Sq virgin
641source code, referenced by other parts of the source tree.
642(Deprecated; use
643.Pa external/
644instead.)
645.It Pa distrib/
646Tools and data files for making
647.Nx
648releases and distributions.
649.It Pa doc/
650Documentation about the source tree (i.e., about the tree, not about
651how to use the software in the tree.)
652.It Pa etc/
653Source (usually example files) for files in
654.Pa /etc .
655.It Pa external/
656Source for programs from external third parties
657(where
658.Nx
659is the not the primary maintainer),
660grouped by license, and then products per license.
661.Pp
662.Bl -tag -width "intel-fw-public/" -compact
663.It Pa apache2/
664Apache 2.0 license.
665.It Pa bsd/
666BSD (or equivalent) licensed software,
667possibly with the
668.Dq advertising clause .
669.It Pa cddl/
670Common Development and Distribution License (the Sun license which is
671based on the Mozilla Public License version 1.1).
672.It Pa gpl2/
673GNU Public License, version 2 (or earlier).
674.It Pa gpl3/
675GNU Public License, version 3.
676.It Pa historical/
677Lucent's old license.
678.It Pa ibm-public/
679IBM's public license.
680.It Pa intel-fw-eula/
681Intel firmware license with redistribution restricted to OEM.
682.It Pa intel-fw-public/
683Intel firmware license permitting redistribution with
684terms similar to BSD licensed software.
685.It Pa intel-public/
686Intel license permitting redistribution with terms similar to
687BSD licensed software.
688.It Pa mit/
689MIT (X11) style license.
690.It Pa zlib/
691BSD-like zlib license.
692.El
693.Pp
694.It Pa games/
695Source for utilities/files in
696.Pa /usr/games .
697.It Pa gnu/
698Source for programs covered by the GNU license (or similar)
699(deprecated; use
700.Pa external/gpl2/
701or
702.Pa external/gpl3/
703as appropriate).
704.It Pa include/
705Source for files in
706.Pa /usr/include .
707.It Pa lib/
708Source for libraries in
709.Pa /usr/lib .
710.It Pa libexec/
711Source for utilities/files in
712.Pa /usr/libexec .
713.It Pa regress/
714Various legacy regression tests.
715.It Pa rescue/
716Source/makefiles for
717.Pa /rescue .
718.It Pa sbin/
719Source for utilities/files in
720.Pa /sbin .
721.It Pa share/
722Source for files in
723.Pa /usr/share .
724.Pp
725.Bl -tag -width "doc/" -compact
726.It Pa doc/
727.Pp
728.Bl -tag -width "papers/" -compact
729.It Pa papers/
730Source for various historical technical papers (many from Berkeley).
731.It Pa psd/
732Source for Programmer's Supplementary Documents.
733.It Pa smm/
734Source for System Manager's Manual.
735.It Pa usd/
736Source for User's Supplementary Documents.
737.El
738.El
739.It Pa sys/
740Kernel source files.
741.Pp
742.Bl -tag -width "gdbscripts/" -compact
743.It Pa arch/
744Architecture-specific support.
745.Pp
746.Bl -tag -width "playstation2/" -compact
747.It Pa acorn26/
748Acorn Archimedes, A-series and R-series systems.
749.It Pa acorn32/
750Acorn RiscPC/A7000 and VLSI RC7500.
751.It Pa algor/
752Algorithmics Ltd. MIPS evaluations boards.
753.It Pa alpha/
754Digital/Compaq Alpha.
755.It Pa amd64/
756Computers with x86_64 capable CPUs.
757.It Pa amiga/
758Commodore Amiga and MacroSystem DraCo.
759.It Pa amigappc/
760PowerPC based Amiga boards.
761.It Pa arc/
762MIPS-based machines following the Advanced RISC Computing spec.
763.It Pa arm/
764ARM processor general support.
765.It Pa atari/
766Atari TT030, Falcon and Hades.
767.It Pa bebox/
768Be Inc. BeBox.
769.It Pa cats/
770Chalice Technology's CATS and Intel's EBSA-285 evaluation boards.
771.It Pa cesfic/
772CES FIC8234 VME processor board.
773.It Pa cobalt/
774Cobalt Networks' MIPS-based Microserver.
775.It Pa dreamcast/
776Sega Dreamcast game console.
777.It Pa emips/
778Machines based on Extensible MIPS.
779.It Pa evbarm/
780ARM based evaluation boards.
781.It Pa evbmips/
782MIPS based evaluation boards.
783.It Pa evbppc/
784PowerPC based evaluation boards and appliances.
785.It Pa evbsh3/
786SH3/SH4 based evaluation boards.
787.It Pa ews4800mips/
788NEC's MIPS based EWS4800 workstations.
789.It Pa hp300/
790Hewlett-Packard 9000/300 and 400 680x0-based workstations.
791.It Pa hppa/
792Hewlett-Packard 9000/700 and 9000/800 HPPA based workstations.
793.It Pa hpcarm/
794StrongARM based WinCE PDA machines.
795.It Pa hpcmips/
796MIPS based WinCE PDA machines.
797.It Pa hpcsh/
798Hitachi SH3/4 based WinCE PDA machines.
799.It Pa hppa/
800HPPA processor general support.
801.It Pa i386/
80232-bit 80x86-based IBM PCs and clones.
803.It Pa ibmnws/
804IBM Network Station 1000.
805.It Pa iyonix/
806Castle Technology's Iyonix ARM based PCs.
807.It Pa luna68k/
808Omron Tateishi Electric's 680x0-based LUNA workstations.
809.It Pa m68k/
810680x0 processor general support.
811.It Pa mac68k/
812Apple Macintosh with 68k CPU.
813.It Pa macppc/
814Apple Power Macintosh and clones.
815.It Pa mips/
816MIPS processor general support.
817.It Pa mipsco/
818MIPS Computer Systems Inc. family of workstations and servers.
819.It Pa mmeye/
820Brains Inc. SH3 based mmEye multimedia server.
821.It Pa mvme68k/
822Motorola MVME 680x0-based SBCs.
823.It Pa mvmeppc/
824Motorola PowerPC VME SBCs.
825.It Pa netwinder/
826StrongARM based NetWinder machines.
827.It Pa news68k/
828Sony's 680x0-based NEWS workstations.
829.It Pa newsmips/
830Sony's MIPS-based NEWS workstations.
831.It Pa next68k/
832NeXT 68k "black" hardware.
833.It Pa ofppc/
834Open Firmware PowerPC workstations.
835.It Pa playstation2/
836SONY PlayStation 2.
837.It Pa pmax/
838Digital MIPS-based DECstations and DECsystems.
839.It Pa powerpc/
840PowerPC processor general support.
841.It Pa prep/
842PReP (PowerPC Reference Platform) and CHRP (Common Hardware Reference
843Platform) machines.
844.It Pa sandpoint/
845Motorola Sandpoint reference platform.
846.It Pa sbmips/
847Broadcom/SiByte evaluation boards.
848.It Pa sgimips/
849Silicon Graphics' MIPS-based workstations.
850.It Pa sh3/
851SH3/SH4 processor general support.
852.It Pa shark/
853Digital DNARD ("Shark").
854.It Pa sparc/
855Sun Microsystems SPARC (32-bit) and UltraSPARC (in 32-bit mode).
856.It Pa sparc64/
857Sun Microsystems UltraSPARC (in native 64-bit mode).
858.It Pa sun2/
859Sun Microsystems 68010-based Sun 2 architecture.
860.It Pa sun3/
861Sun Microsystems 68020/68030-based Sun 3/3x architecture.
862.It Pa sun68k/
863680x0-based Sun architecture general support.
864.It Pa vax/
865Digital VAX.
866.It Pa x68k/
867Sharp X680x0 680x0-based workstations.
868.It Pa x86/
869General support for PC/AT compatibles with ia32 or x86_64 CPUs.
870.It Pa xen/
871The Xen virtual machine monitor.
872.It Pa zaurus/
873Sharp C3x00 Arm based PDA.
874.El
875.Pp
876.It Pa compat/
877Kernel compatibility modules directory.
878.Pp
879.Bl -tag -width "ossaudio/" -compact
880.It Pa common/
881Common compatibility routines, old
882.Bx 4
883and
884.Nx
885routines.
886.It Pa freebsd/
887Support for
888.Fx
889binaries; see
890.Xr compat_freebsd 8 .
891.It Pa hpux/
892Support for 68000 HP-UX binaries.
893.It Pa ibcs2/
894Support for Intel Binary binaries.
895.It Pa linux/
896Support for Linux binaries; see
897.Xr compat_linux 8 .
898.It Pa m68k4k/
899Support for 4KB page 68000 binaries.
900.It Pa netbsd32/
901Support for
902.Nx
90332-bit binaries on 64 bit platforms with compatible CPU families.
904.It Pa osf1/
905Support for Digital
906.Ux
907(formerly OSF/1) binaries.
908.It Pa ossaudio/
909Support for OSS audio.
910.It Pa sunos/
911Support for SunOS 4.x binaries; see
912.Xr compat_sunos 8 .
913.It Pa svr4/
914Support for System V Release 4 binaries; see
915.Xr compat_svr4 8 .
916.It Pa ultrix/
917Support for ULTRIX binaries.
918.It Pa vax1k/
919Support for older VAX binaries that started on a 1 KB boundary.
920.El
921.Pp
922.It Pa conf/
923Architecture independent configuration directory.
924.It Pa crypto/
925Cryptographic kernel source, which may have import or export restrictions.
926.It Pa ddb/
927In-kernel debugger.
928.It Pa dev/
929Architecture independent device support.
930.It Pa fs/
931File systems.
932See also
933.Pa ufs/
934and
935.Pa miscfs/ .
936.Bl -tag -width "filecorefs/" -compact
937.It Pa adosfs/
938AmigaDOS file-system support; see
939.Xr mount_ados 8 .
940.It Pa cd9660/
941Support for the ISO-9660 file system; see
942.Xr mount_cd9660 8 .
943.It Pa filecorefs/
944Support for the Acorn RISC OS filecore file system; see
945.Xr mount_filecore 8 .
946.It Pa msdosfs/
947MS-DOS file system; see
948.Xr mount_msdos 8 .
949.It Pa ntfs/
950NTFS file system support; see
951.Xr mount_ntfs 8 .
952.It Pa ptyfs/
953Pseudo-terminal device file system; see
954.Xr mount_ptyfs 8 .
955.It Pa smbfs/
956SMB/CIFS file system support; see
957.Xr mount_smbfs 8 .
958.It Pa union/
959Union file system; see
960.Xr mount_union 8 .
961.El
962.It Pa gdbscripts/
963Support for accessing kernel structures from within the debugger
964.Xr gdb 1 .
965.It Pa ipkdb/
966Support for kernel debugging over the network.
967.Pp
968.It Pa kern/
969Primary kernel source code.
970.It Pa lib/
971Libraries supporting the kernel.
972.Pp
973.Bl -tag -width "libkern/" -compact
974.It Pa libkern/
975C library routines used in the kernel.
976.It Pa libsa/
977Machine-independent standalone library, used by boot loaders.
978.It Pa libz/
979Compression library.
980.El
981.Pp
982.It Pa miscfs/
983More file systems.
984.Pp
985.Bl -tag -width "deadfs/" -compact
986.It Pa deadfs/
987Kernel only dead file system.
988.It Pa fdesc/
989File descriptor file system; see
990.Xr mount_fdesc 8 .
991.It Pa fifofs/
992POSIX FIFO (named pipe) support.
993.It Pa genfs/
994Generic file system code that supports other file systems.
995.It Pa kernfs/
996Kernel namespace file system; see
997.Xr mount_kernfs 8 .
998.It Pa nullfs/
999Loop back file system; see
1000.Xr mount_null 8 .
1001.It Pa overlay/
1002Overlay file system; see
1003.Xr mount_overlay 8 .
1004.It Pa procfs/
1005Process file system; see
1006.Xr mount_procfs 8 .
1007.It Pa specfs/
1008Support for block and character special files.
1009.It Pa syncfs/
1010Kernel trickle sync algorithm.
1011.It Pa umapfs/
1012User and group re-mapping file system; see
1013.Xr mount_umap 8 .
1014.El
1015.Pp
1016.It Pa net/
1017Miscellaneous networking support.
1018.It Pa netatalk/
1019AppleTalk networking support.
1020.It Pa netinet/
1021IP networking support.
1022.It Pa netinet6/
1023IPv6 networking support.
1024.It Pa netkey/
1025Key database for IPsec networking support.
1026.It Pa netnatm/
1027ATM networking support.
1028.It Pa nfs/
1029NFS (network file system) support, both client and server.
1030.It Pa stand/
1031Kernel standalone support.
1032.It Pa sys/
1033Kernel (and system) include files.
1034.It Pa ufs/
1035Still more file systems.
1036.Pp
1037.Bl -tag -width "ffs/" -compact
1038.It Pa chfs/
1039A FFS-based file system for use on raw flash.
1040.It Pa ext2fs/
1041The Linux ext2 file system.
1042.It Pa ffs/
1043The Berkeley Fast File System.
1044.It Pa lfs/
1045The Berkeley log-structured file system.
1046.It Pa mfs/
1047The in-memory file system.
1048.It Pa ufs/
1049Shared
1050.Ux
1051file system support.
1052.El
1053.It Pa uvm/
1054UVM virtual memory system.
1055.El
1056.It Pa tests/
1057Source for test programs in
1058.Pa /usr/tests .
1059.It Pa usr.bin/
1060Source for utilities/files in
1061.Pa /usr/bin .
1062.It Pa usr.sbin/
1063Source for utilities/files in
1064.Pa /usr/sbin .
1065.El
1066.It Pa /var/
1067Multi-purpose log, temporary, transient, and spool files.
1068.Pp
1069.Bl -tag -width "preserve/" -compact
1070.It Pa account/
1071System accounting files.
1072.Pp
1073.Bl -tag -width "acct" -compact
1074.It Pa acct
1075Execution accounting file;
1076see
1077.Xr acct 5 .
1078.El
1079.Pp
1080.It Pa at/
1081Timed command scheduling files;
1082see
1083.Xr at 1 .
1084.It Pa backups/
1085Miscellaneous backup files, largely of files found in
1086.Pa /etc .
1087.It Pa chroot/
1088Home directories of applications which are run in a
1089.Xr chroot 8
1090.Dq cage .
1091.It Pa crash/
1092System (kernel) crash dumps; see
1093.Xr savecore 8 .
1094.It Pa cron/
1095Scheduled commands configuration files; see
1096.Xr cron 8
1097and
1098.Xr crontab 5 .
1099.It Pa db/
1100Miscellaneous automatically generated system-specific database files,
1101and persistent files used in the maintenance of third party software.
1102.Pp
1103.Bl -tag -width "monthly.out" -compact
1104.It Pa pkg
1105Default location for metadata related to third party software
1106packages.
1107See
1108.Xr pkg_add 1
1109for more details of the
1110.Nx
1111Packages Collection, or pkgsrc.
1112.El
1113.Pp
1114.It Pa games/
1115Miscellaneous game status, log, and high score files.
1116.It Pa heimdal/
1117Kerberos 5 KDC database; see
1118.Xr kdc 8 .
1119.It Pa log/
1120Miscellaneous system log files.
1121.Pp
1122.Bl -tag -width "monthly.out" -compact
1123.It Pa amd.*
1124.Xr amd 8
1125logs.
1126.It Pa daily.out
1127Output of the last run of the
1128.Pa /etc/daily
1129script.
1130.It Pa ftp.*
1131.Xr ftp 1
1132logs.
1133.It Pa kerberos.*
1134.Xr kerberos 8
1135logs.
1136.It Pa lastlog
1137System last-time-logged-in database; see
1138.Xr utmp 5 .
1139.It Pa lpd-errs.*
1140Printer daemon error logs; see
1141.Xr lpd 8 .
1142.It Pa maillog.*
1143.Xr sendmail 1
1144and
1145.Xr postfix 1
1146(and other mail-related)
1147log files.
1148.It Pa messages.*
1149General system information log.
1150.It Pa monthly.out
1151Output of the last run of the
1152.Pa /etc/monthly
1153script.
1154.It Pa secure
1155Sensitive security information log.
1156.It Pa sendmail.st
1157.Xr sendmail 1
1158statistics.
1159.It Pa timed.*
1160.Xr timed 8
1161logs.
1162.It Pa weekly.out
1163Output of the last run of the
1164.Pa /etc/weekly
1165script.
1166.It Pa wtmp
1167Login and logout log;
1168see
1169.Xr utmp 5 .
1170.It Pa wtmpx
1171Another login and logout log; see
1172.Xr utmpx 5 .
1173.El
1174.Pp
1175.It Pa mail/
1176User e-mail inboxes.
1177.It Pa msgs/
1178System messages; see
1179.Xr msgs 1 .
1180.\" since we use nvi (now called vi) this isn't the place any more, is it?
1181.It Pa preserve/
1182Temporary home of files preserved after an accidental death of
1183.Xr ex 1
1184or
1185.Xr vi 1 .
1186.It Pa quotas/
1187File system quota information.
1188(Legacy.)
1189.It Pa run/
1190System information files, rebuilt after each reboot.
1191.Pp
1192.Bl -tag -width "utmp" -compact
1193.It Pa dmesg.boot
1194A dump from
1195.Xr dmesg 8
1196taken at boot time.
1197.It Pa utmp
1198Database of currently logged in users; see
1199.Xr utmp 5 .
1200.It Pa utmpx
1201Another database of currently logged in users; see
1202.Xr utmpx 5 .
1203.El
1204.Pp
1205.It Pa rwho/
1206Rwho data files; see
1207.Xr rwhod 8 ,
1208.Xr rwho 1 ,
1209and
1210.Xr ruptime 1 .
1211.It Pa spool/
1212Miscellaneous printer and mail system spooling directories.
1213.Pp
1214.Bl -tag -width "postfix/" -compact
1215.It Pa ftp/
1216Commonly
1217.Dq ~ftp ,
1218the anonymous ftp root directory; see
1219.Xr ftpd 8 .
1220.It Pa mqueue/
1221Sendmail mail queue;
1222see
1223.Xr sendmail 1 .
1224.It Pa news/
1225Network news archival and spooling directories.
1226.It Pa output/
1227Printer spooling directories.
1228.It Pa postfix/
1229Postfix mail queue;
1230see
1231.Xr postfix 1 .
1232.El
1233.Pp
1234.It Pa tmp/
1235Temporary files that are not discarded between system reboots.
1236.Pp
1237.Bl -tag -width "vi.recover/" -compact
1238.It Pa vi.recover/
1239Recovery directory for new (current)
1240.Xr vi 1 .
1241.El
1242.Pp
1243.It Pa yp/
1244Databases and configuration for the NIS (YP) system; see
1245.Xr nis 8 .
1246.El
1247.El
1248.Sh SEE ALSO
1249.Xr apropos 1 ,
1250.Xr ls 1 ,
1251.Xr whatis 1 ,
1252.Xr whereis 1 ,
1253.Xr which 1 ,
1254.Xr paths 3
1255.Sh HISTORY
1256A
1257.Nm
1258manual page appeared in
1259.At v7 .
1260