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