xref: /netbsd-src/share/man/man7/hier.7 (revision e89934bbf778a6d6d6894877c4da59d0c7835b0f)
1.\"	$NetBSD: hier.7,v 1.122 2016/08/27 03:57:21 dholland 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 26, 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, 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 Sy /tmp/
413Temporary files.
414The contents of
415.Pa /tmp
416are usually
417.Em not
418preserved across a system reboot.
419.It Sy /usr/
420Contains the majority of the system utilities and files.
421.Pp
422.Bl -tag -width "libdata/" -compact
423.It Sy X11R6/
424X11 files (for X11 revision 6).
425.It Sy X11R7/
426X11 files (for X11 revision 7).
427.Pp
428.Bl -tag -width "include/" -compact
429.It Sy bin/
430X11 binaries.
431.It Sy include/
432X11 include files.
433.It Sy lib/
434X11 libraries.
435.El
436.Pp
437.It Sy bin/
438Common utilities, programming tools, and applications.
439.It Sy games/
440The important stuff.
441.It Sy include/
442Standard C (and extension) include files.
443.Pp
444.Bl -tag -width "protocols/" -compact
445.It Sy arpa/
446Include files for Internet service protocols.
447.It Sy atf/
448Include files for the Automated Testing Framework; see
449.Xr atf 7 .
450.It Sy g++/
451Include files for the GNU C++ compiler.
452.It Sy machine/
453Machine specific include files.
454.It Sy net/
455Miscellaneous network include files.
456.It Sy netatalk/
457C include files for AppleTalk protocols
458see
459.Xr atalk 4 .
460.It Sy netinet/
461Include files for Internet standard protocols; see
462.Xr inet 4 .
463.It Sy netinet6/
464Include files for Internet protocol version 6; see
465.Xr inet6 4 .
466.It Sy netkey/
467Include files for secret key management, used for security protocols; see
468.Xr ipsec 4 .
469.It Sy netnatm/
470C include files for native mode ATM.
471.It Sy nfs/
472C include files for NFS (Network File System).
473.It Sy protocols/
474C include files for Berkeley service protocols.
475.It Sy sys/
476``System-level'' C include files.
477.It Sy ufs/
478C include files for several mutually related file systems.
479(The `u' was originally for
480.Ux . )
481.El
482.Pp
483.It Sy lib/
484Archive, profiled, position independent archive, and shared libraries.
485.Pp
486.Bl -tag -width "lua/" -compact
487.It Sy lua/
488.Bl -tag -width "5.3/" -compact
489.It Sy 5.3/
490Lua 5.3 modules.
491.El
492.El
493.Pp
494.It Sy libdata/
495Miscellaneous utility data files.
496.It Sy libexec/
497System daemons \*[Am] system utilities (executed by other programs).
498.Pp
499.It Sy mdec/
500Boot blocks, etc.
501.It Sy obj/
502Architecture-specific target tree produced by building the
503.Pa /usr/src
504tree; often a symbolic link or mounted file system.
505.It Sy pkg/
506Installed third-party software packages.
507.Pp
508.Bl -tag -width "include/" -compact
509.It Sy bin/
510Package binaries.
511.It Sy include/
512Package include files.
513.It Sy lib/
514Package libraries.
515.It Sy libdata/
516Package data files.
517.It Sy libexec/
518Package daemons.
519.It Sy sbin/
520Package system utilities.
521.El
522.Pp
523.It Sy pkgsrc/
524Build descriptions (packaging) for the
525.Nx
526package system.
527.Pp
528.Bl -tag -width "distfilesX" -compact
529.It Sy distfiles/
530Downloaded upstream source archives.
531.It Sy 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 Sy sbin/
539System daemons and system utilities (normally executed by the super-user).
540.It Sy share/
541Architecture-independent files, mostly text.
542.Pp
543.Bl -tag -width "calendar/" -compact
544.It Sy calendar/
545A variety of calendar files; see
546.Xr calendar 1 .
547.It Sy dict/
548Word lists;
549see
550.Xr look 1
551and
552.Xr spell 1 .
553.Pp
554.Bl -tag -width "special/" -compact
555.It Sy words
556Common words.
557.It Sy web2
558Words from Webster's Second International Dictionary.
559.It Sy papers/
560Reference databases;
561see
562.Xr refer 1 .
563.It Sy special/
564Custom word lists;
565see
566.Xr spell 1 .
567.El
568.Pp
569.It Sy doc/
570Miscellaneous documentation.
571.It Sy games/
572Data files used by various games.
573.It Sy i18n/
574internationalization databases; see
575.Xr iconv 3 .
576.It Sy locale/
577Locale databases and gettext message catalogs; see
578.Xr setlocale 3
579and
580.Xr gettext 3 .
581.It Sy man/
582Manual pages.
583.It Sy me/
584Macros for use with the
585.Xr me 7
586roff macro package.
587.It Sy misc/
588Miscellaneous system-wide text files.
589.Pp
590.Bl -tag -width "terminfo.cdb" -compact
591.It Sy terminfo
592Terminal characteristics database;
593see
594.Xr terminfo 5 .
595.It Sy terminfo.cdb
596database form of terminfo file; see
597.Xr tic 1 .
598.El
599.Pp
600.It Sy mk/
601Include files for
602.Xr make 1 .
603.It Sy ms/
604Macros for use with the
605.Xr ms 7
606roff macro package.
607.It Sy nls/
608Message catalogs; see
609.Xr catgets 3 .
610.It Sy tmac/
611Text processing macros;
612see
613.Xr nroff 1
614and
615.Xr troff 1 .
616.It Sy zoneinfo/
617Time zone database;
618see
619.Xr tzfile 5 .
620.El
621.It Sy tests/
622Test programs; see
623.Xr tests 7
624for information on how to run them.
625.El
626.Pp
627.It Sy /usr/src/
628.Nx
629and local source files.
630.Pp
631.Bl -tag -width "domestic/" -compact
632.It Sy bin/
633Source for utilities/files in
634.Pa /bin .
635.It Sy common/
636Sources shared between kernel and userland.
637.It Sy crypto/
638Cryptographic source, which may have import or export restrictions.
639.It Sy dist/
640Third-party
641.Sq virgin
642source code, referenced by other parts of the source tree.
643(Deprecated; use
644.Sy external/
645instead.)
646.It Sy distrib/
647Tools and data files for making
648.Nx
649releases and distributions.
650.It Sy doc/
651Documentation about the source tree (i.e., about the tree, not about
652how to use the software in the tree.)
653.It Sy etc/
654Source (usually example files) for files in
655.Pa /etc .
656.It Sy external/
657Source for programs from external third parties
658(where
659.Nx
660is the not the primary maintainer),
661grouped by license, and then products per license.
662.Pp
663.Bl -tag -width "intel-fw-public/" -compact
664.It Sy apache2/
665Apache 2.0 license.
666.It Sy bsd/
667BSD (or equivalent) licensed software,
668possibly with the
669.Dq advertising clause .
670.It Sy cddl/
671Common Development and Distribution License (the Sun license which is
672based on the Mozilla Public License version 1.1).
673.It Sy gpl2/
674GNU Public License, version 2 (or earlier).
675.It Sy gpl3/
676GNU Public License, version 3.
677.It Sy historical/
678Lucent's old license.
679.It Sy ibm-public/
680IBM's public license.
681.It Sy intel-fw-eula/
682Intel firmware license with redistribution restricted to OEM.
683.It Sy intel-fw-public/
684Intel firmware license permitting redistribution with
685terms similar to BSD licensed software.
686.It Sy intel-public/
687Intel license permitting redistribution with terms similar to
688BSD licensed software.
689.It Sy mit/
690MIT (X11) style license.
691.It Sy zlib/
692BSD-like zlib license.
693.El
694.Pp
695.It Sy games/
696Source for utilities/files in
697.Pa /usr/games .
698.It Sy gnu/
699Source for programs covered by the
700.Tn GNU
701license (or similar) (deprecated; use
702.Sy external/gpl2/
703or
704.Sy external/gpl3/
705as appropriate).
706.It Sy include/
707Source for files in
708.Pa /usr/include .
709.It Sy lib/
710Source for libraries in
711.Pa /usr/lib .
712.It Sy libexec/
713Source for utilities/files in
714.Pa /usr/libexec .
715.It Sy regress/
716Various legacy regression tests.
717.It Sy rescue/
718Source/makefiles for
719.Pa /rescue .
720.It Sy sbin/
721Source for utilities/files in
722.Pa /sbin .
723.It Sy share/
724Source for files in
725.Pa /usr/share .
726.Pp
727.Bl -tag -width "doc/" -compact
728.It Sy doc/
729.Pp
730.Bl -tag -width "papers/" -compact
731.It Sy papers/
732Source for various historical technical papers (many from Berkeley).
733.It Sy psd/
734Source for Programmer's Supplementary Documents.
735.It Sy smm/
736Source for System Manager's Manual.
737.It Sy usd/
738Source for User's Supplementary Documents.
739.Pp
740.El
741.El
742.It Sy sys/
743Kernel source files.
744.Pp
745.Bl -tag -width "gdbscripts/" -compact
746.It Sy arch/
747Architecture-specific support.
748.Pp
749.Bl -tag -width "playstation2/" -compact
750.It Sy acorn26/
751Acorn Archimedes, A-series and R-series systems.
752.It Sy acorn32/
753Acorn RiscPC/A7000 and VLSI RC7500.
754.It Sy algor/
755Algorithmics Ltd. MIPS evaluations boards.
756.It Sy alpha/
757Digital/Compaq Alpha.
758.It Sy amd64/
759Computers with x86_64 capable CPUs.
760.It Sy amiga/
761Commodore Amiga and MacroSystem DraCo.
762.It Sy amigappc/
763PowerPC based Amiga boards.
764.It Sy arc/
765MIPS-based machines following the Advanced RISC Computing spec.
766.It Sy arm/
767ARM processor general support.
768.It Sy atari/
769Atari TT030, Falcon and Hades.
770.It Sy bebox/
771Be Inc. BeBox.
772.It Sy cats/
773Chalice Technology's CATS and Intel's EBSA-285 evaluation boards.
774.It Sy cesfic/
775CES FIC8234 VME processor board.
776.It Sy cobalt/
777Cobalt Networks' MIPS-based Microserver.
778.It Sy dreamcast/
779Sega Dreamcast game console.
780.It Sy emips/
781Machines based on Extensible MIPS.
782.It Sy evbarm/
783ARM based evaluation boards.
784.It Sy evbmips/
785MIPS based evaluation boards.
786.It Sy evbppc/
787PowerPC based evaluation boards and appliances.
788.It Sy evbsh3/
789SH3/SH4 based evaluation boards.
790.It Sy ews4800mips/
791NEC's MIPS based EWS4800 workstations.
792.It Sy hp300/
793Hewlett-Packard 9000/300 and 400 680x0-based workstations.
794.It Sy hppa/
795Hewlett-Packard 9000/700 and 9000/800 HPPA based workstations.
796.It Sy hpcarm/
797StrongARM based WinCE PDA machines.
798.It Sy hpcmips/
799MIPS based WinCE PDA machines.
800.It Sy hpcsh/
801Hitachi SH3/4 based WinCE PDA machines.
802.It Sy hppa/
803HPPA processor general support.
804.It Sy i386/
80532-bit 80x86-based IBM PCs and clones.
806.It Sy ibmnws/
807IBM Network Station 1000.
808.It Sy iyonix/
809Castle Technology's Iyonix ARM based PCs.
810.It Sy luna68k/
811Omron Tateishi Electric's 680x0-based LUNA workstations.
812.It Sy m68k/
813680x0 processor general support.
814.It Sy mac68k/
815Apple Macintosh with 68k CPU.
816.It Sy macppc/
817Apple Power Macintosh and clones.
818.It Sy mips/
819MIPS processor general support.
820.It Sy mipsco/
821MIPS Computer Systems Inc. family of workstations and servers.
822.It Sy mmeye/
823Brains Inc. SH3 based mmEye multimedia server.
824.It Sy mvme68k/
825Motorola MVME 680x0-based SBCs.
826.It Sy mvmeppc/
827Motorola PowerPC VME SBCs.
828.It Sy netwinder/
829StrongARM based NetWinder machines.
830.It Sy news68k/
831Sony's 680x0-based NEWS workstations.
832.It Sy newsmips/
833Sony's MIPS-based NEWS workstations.
834.It Sy next68k/
835NeXT 68k "black" hardware.
836.It Sy ofppc/
837Open Firmware PowerPC workstations.
838.It Sy playstation2/
839SONY PlayStation 2.
840.It Sy pmax/
841Digital MIPS-based DECstations and DECsystems.
842.It Sy powerpc/
843PowerPC processor general support.
844.It Sy prep/
845PReP (PowerPC Reference Platform) and CHRP (Common Hardware Reference
846Platform) machines.
847.It Sy sandpoint/
848Motorola Sandpoint reference platform.
849.It Sy sbmips/
850Broadcom/SiByte evaluation boards.
851.It Sy sgimips/
852Silicon Graphics' MIPS-based workstations.
853.It Sy sh3/
854SH3/SH4 processor general support.
855.It Sy shark/
856Digital DNARD ("Shark").
857.It Sy sparc/
858Sun Microsystems SPARC (32-bit) and UltraSPARC (in 32-bit mode).
859.It Sy sparc64/
860Sun Microsystems UltraSPARC (in native 64-bit mode).
861.It Sy sun2/
862Sun Microsystems 68010-based Sun 2 architecture.
863.It Sy sun3/
864Sun Microsystems 68020/68030-based Sun 3/3x architecture.
865.It Sy sun68k/
866680x0-based Sun architecture general support.
867.It Sy vax/
868Digital VAX.
869.It Sy x68k/
870Sharp X680x0 680x0-based workstations.
871.It Sy x86/
872General support for PC/AT compatibles with ia32 or x86_64 CPUs.
873.It Sy xen/
874The Xen virtual machine monitor.
875.It Sy zaurus/
876Sharp C3x00 Arm based PDA.
877.El
878.Pp
879.It Sy compat/
880Kernel compatibility modules directory.
881.Pp
882.Bl -tag -width "ossaudio/" -compact
883.It Sy common/
884Common compatibility routines, old
885.Bx 4
886and
887.Nx
888routines.
889.It Sy freebsd/
890Support for
891.Fx
892binaries; see
893.Xr compat_freebsd 8 .
894.It Sy hpux/
895Support for 68000 HP-UX binaries.
896.It Sy ibcs2/
897Support for Intel Binary binaries.
898.It Sy linux/
899Support for Linux binaries; see
900.Xr compat_linux 8 .
901.It Sy m68k4k/
902Support for 4KB page 68000 binaries.
903.It Sy netbsd32/
904Support for
905.Nx
90632-bit binaries on 64 bit platforms with compatible CPU families.
907.It Sy osf1/
908Support for
909.Tn Digital
910.Ux
911.Po
912formerly
913.Tn OSF/1
914.Pc
915binaries.
916.It Sy ossaudio/
917Support for OSS audio.
918.It Sy sunos/
919Support for
920.Tn SunOS 4.x
921binaries; see
922.Xr compat_sunos 8 .
923.It Sy svr4/
924Support for System V Release 4 binaries; see
925.Xr compat_svr4 8 .
926.It Sy ultrix/
927Support for
928.Tn ULTRIX
929binaries.
930.It Sy vax1k/
931Support for older VAX binaries that started on a 1 KB boundary.
932.El
933.Pp
934.It Sy conf/
935Architecture independent configuration directory.
936.It Sy crypto/
937Cryptographic kernel source, which may have import or export restrictions.
938.It Sy ddb/
939In-kernel debugger.
940.It Sy dev/
941Architecture independent device support.
942.It Sy fs/
943File systems.
944See also
945.Sy ufs/
946and
947.Sy miscfs/ .
948.Bl -tag -width "filecorefs/" -compact
949.It Sy adosfs/
950AmigaDOS file-system support; see
951.Xr mount_ados 8 .
952.It Sy cd9660/
953Support for the ISO-9660 file system; see
954.Xr mount_cd9660 8 .
955.It Sy filecorefs/
956Support for the Acorn RISC OS filecore file system; see
957.Xr mount_filecore 8 .
958.It Sy msdosfs/
959.Tn MS-DOS
960file system; see
961.Xr mount_msdos 8 .
962.It Sy ntfs/
963NTFS file system support; see
964.Xr mount_ntfs 8 .
965.It Sy ptyfs/
966Pseudo-terminal device file system; see
967.Xr mount_ptyfs 8 .
968.It Sy smbfs/
969SMB/CIFS file system support; see
970.Xr mount_smbfs 8 .
971.It Sy union/
972Union file system; see
973.Xr mount_union 8 .
974.El
975.It Sy gdbscripts/
976Support for accessing kernel structures from within the debugger
977.Xr gdb 1 .
978.It Sy ipkdb/
979Support for kernel debugging over the network.
980.Pp
981.It Sy kern/
982Primary kernel source code.
983.It Sy lib/
984Libraries supporting the kernel.
985.Pp
986.Bl -tag -width "libkern/" -compact
987.It Sy libkern/
988C library routines used in the kernel.
989.It Sy libsa/
990Machine-independent standalone library, used by boot loaders.
991.It Sy libz/
992Compression library.
993.El
994.Pp
995.It Sy miscfs/
996More file systems.
997.Pp
998.Bl -tag -width "deadfs/" -compact
999.It Sy deadfs/
1000Kernel only dead file system.
1001.It Sy fdesc/
1002File descriptor file system; see
1003.Xr mount_fdesc 8 .
1004.It Sy fifofs/
1005POSIX FIFO (named pipe) support.
1006.It Sy genfs/
1007Generic file system code that supports other file systems.
1008.It Sy kernfs/
1009Kernel namespace file system; see
1010.Xr mount_kernfs 8 .
1011.It Sy nullfs/
1012Loop back file system; see
1013.Xr mount_null 8 .
1014.It Sy overlay/
1015Overlay file system; see
1016.Xr mount_overlay 8 .
1017.It Sy procfs/
1018Process file system; see
1019.Xr mount_procfs 8 .
1020.It Sy specfs/
1021Support for block and character special files.
1022.It Sy syncfs/
1023Kernel trickle sync algorithm.
1024.It Sy umapfs/
1025User and group re-mapping file system; see
1026.Xr mount_umap 8 .
1027.El
1028.Pp
1029.It Sy net/
1030Miscellaneous networking support.
1031.It Sy netatalk/
1032AppleTalk networking support.
1033.It Sy netinet/
1034IP networking support.
1035.It Sy netinet6/
1036IPv6 networking support.
1037.It Sy netkey/
1038Key database for IPsec networking support.
1039.It Sy netnatm/
1040ATM networking support.
1041.It Sy nfs/
1042NFS (network file system) support, both client and server.
1043.It Sy stand/
1044Kernel standalone support.
1045.It Sy sys/
1046Kernel (and system) include files.
1047.It Sy ufs/
1048Still more file systems.
1049.Pp
1050.Bl -tag -width "ffs/" -compact
1051.It Sy chfs/
1052A FFS-based file system for use on raw flash.
1053.It Sy ext2fs/
1054The Linux ext2 file system.
1055.It Sy ffs/
1056The Berkeley Fast File System.
1057.It Sy lfs/
1058The Berkeley log-structured file system.
1059.It Sy mfs/
1060The in-memory file system.
1061.It Sy ufs/
1062Shared
1063.Ux
1064file system support.
1065.El
1066.It Sy uvm/
1067UVM virtual memory system.
1068.El
1069.It Sy tests/
1070Source for test programs in
1071.Pa /usr/tests .
1072.It Sy usr.bin/
1073Source for utilities/files in
1074.Pa /usr/bin .
1075.It Sy usr.sbin/
1076Source for utilities/files in
1077.Pa /usr/sbin .
1078.El
1079.It Sy /var/
1080Multi-purpose log, temporary, transient, and spool files.
1081.Pp
1082.Bl -tag -width "preserve/" -compact
1083.It Sy account/
1084System accounting files.
1085.Pp
1086.Bl -tag -width "acct" -compact
1087.It Sy acct
1088Execution accounting file;
1089see
1090.Xr acct 5 .
1091.El
1092.Pp
1093.It Sy at/
1094Timed command scheduling files;
1095see
1096.Xr at 1 .
1097.It Sy backups/
1098Miscellaneous backup files, largely of files found in
1099.Pa /etc .
1100.It Sy chroot/
1101Home directories of applications which are run in a
1102.Xr chroot 8
1103.Dq cage .
1104.It Sy crash/
1105System (kernel) crash dumps; see
1106.Xr savecore 8 .
1107.It Sy cron/
1108Scheduled commands configuration files; see
1109.Xr cron 8
1110and
1111.Xr crontab 5 .
1112.It Sy db/
1113Miscellaneous automatically generated system-specific database files,
1114and persistent files used in the maintenance of third party software.
1115.Pp
1116.Bl -tag -width "monthly.out" -compact
1117.It Sy pkg
1118Default location for metadata related to third party software
1119packages.
1120See
1121.Xr pkg_add 1
1122for more details of the
1123.Nx
1124Packages Collection, or pkgsrc.
1125.El
1126.Pp
1127.It Sy games/
1128Miscellaneous game status, log, and high score files.
1129.It Sy heimdal/
1130Kerberos 5 KDC database; see
1131.Xr kdc 8 .
1132.It Sy log/
1133Miscellaneous system log files.
1134.Pp
1135.Bl -tag -width "monthly.out" -compact
1136.It Sy amd.*
1137.Xr amd 8
1138logs.
1139.It Sy daily.out
1140Output of the last run of the
1141.Pa /etc/daily
1142script.
1143.It Sy ftp.*
1144.Xr ftp 1
1145logs.
1146.It Sy kerberos.*
1147.Xr kerberos 8
1148logs.
1149.It Sy lastlog
1150System last-time-logged-in database; see
1151.Xr utmp 5 .
1152.It Sy lpd-errs.*
1153Printer daemon error logs; see
1154.Xr lpd 8 .
1155.It Sy maillog.*
1156.Xr sendmail 1
1157and
1158.Xr postfix 1
1159(and other mail-related)
1160log files.
1161.It Sy messages.*
1162General system information log.
1163.It Sy monthly.out
1164Output of the last run of the
1165.Pa /etc/monthly
1166script.
1167.It Sy secure
1168Sensitive security information log.
1169.It Sy sendmail.st
1170.Xr sendmail 1
1171statistics.
1172.It Sy timed.*
1173.Xr timed 8
1174logs.
1175.It Sy weekly.out
1176Output of the last run of the
1177.Pa /etc/weekly
1178script.
1179.It Sy wtmp
1180Login and logout log;
1181see
1182.Xr utmp 5 .
1183.It Sy wtmpx
1184Another login and logout log; see
1185.Xr utmpx 5 .
1186.El
1187.Pp
1188.It Sy mail/
1189User e-mail inboxes.
1190.It Sy msgs/
1191System messages; see
1192.Xr msgs 1 .
1193.\" since we use nvi (now called vi) this isn't the place any more, is it?
1194.It Sy preserve/
1195Temporary home of files preserved after an accidental death of
1196.Xr ex 1
1197or
1198.Xr vi 1 .
1199.It Sy quotas/
1200File system quota information.
1201(Legacy.)
1202.It Sy run/
1203System information files, rebuilt after each reboot.
1204.Pp
1205.Bl -tag -width "utmp" -compact
1206.It Sy dmesg.boot
1207A dump from
1208.Xr dmesg 8
1209taken at boot time.
1210.It Sy utmp
1211Database of currently logged in users; see
1212.Xr utmp 5 .
1213.It Sy utmpx
1214Another database of currently logged in users; see
1215.Xr utmpx 5 .
1216.El
1217.Pp
1218.It Sy rwho/
1219Rwho data files; see
1220.Xr rwhod 8 ,
1221.Xr rwho 1 ,
1222and
1223.Xr ruptime 1 .
1224.It Sy spool/
1225Miscellaneous printer and mail system spooling directories.
1226.Pp
1227.Bl -tag -width "postfix/" -compact
1228.It Sy ftp/
1229Commonly
1230.Dq ~ftp ,
1231the anonymous ftp root directory; see
1232.Xr ftpd 8 .
1233.It Sy mqueue/
1234Sendmail mail queue;
1235see
1236.Xr sendmail 1 .
1237.It Sy news/
1238Network news archival and spooling directories.
1239.It Sy output/
1240Printer spooling directories.
1241.It Sy postfix/
1242Postfix mail queue;
1243see
1244.Xr postfix 1 .
1245.El
1246.Pp
1247.It Sy tmp/
1248Temporary files that are not discarded between system reboots.
1249.Pp
1250.Bl -tag -width "vi.recover/" -compact
1251.It Sy vi.recover/
1252Recovery directory for new (current)
1253.Xr vi 1 .
1254.El
1255.Pp
1256.It Sy yp/
1257Databases and configuration for the NIS (YP) system; see
1258.Xr nis 8 .
1259.El
1260.El
1261.Sh SEE ALSO
1262.Xr apropos 1 ,
1263.Xr ls 1 ,
1264.Xr whatis 1 ,
1265.Xr whereis 1 ,
1266.Xr which 1 ,
1267.Xr paths 3
1268.Sh HISTORY
1269A
1270.Nm
1271manual page appeared in
1272.At v7 .
1273