1 .\" Copyright (c) 1990, 1993
2 .\" The Regents of the University of California. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
12 .\" 3. All advertising materials mentioning features or use of this software
13 .\" must display the following acknowledgement:
14 .\" This product includes software developed by the University of
15 .\" California, Berkeley and its contributors.
16 .\" 4. Neither the name of the University nor the names of its contributors
17 .\" may be used to endorse or promote products derived from this software
18 .\" without specific prior written permission.
20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 .\" @(#)hier.7 8.1 (Berkeley) 6/5/93
33 .\" $FreeBSD: src/share/man/man7/hier.7,v 1.29.2.17 2003/01/13 21:43:50 ceri Exp $
34 .\" $DragonFly: src/share/man/man7/hier.7,v 1.4 2004/03/11 12:28:56 hmp Exp $
41 .Nd layout of filesystems
43 A sketch of the filesystem hierarchy.
44 .Bl -tag -width "/stand/"
46 root directory of the filesystem
48 user utilities fundamental to both single-user and multi-user environments
50 programs and configuration files used during operating system bootstrap
52 .Bl -tag -width defaults/ -compact
54 default bootstrapping configuration files; see
58 block and character device files
60 .Bl -tag -width MAKEDEV -compact
62 script for creating device files;
66 file descriptor files;
71 system configuration files and scripts
73 .Bl -tag -width "disklabels/" -compact
75 default system configuration files;
79 gnats configuration files;
83 isdn4bsd configuration files;
87 local timezone information;
91 Sendmail control files
93 mtree configuration files;
97 named configuration files;
101 scripts that are run daily, weekly, and monthly, via
106 ppp configuration files;
110 OpenSSL configuration files
112 uucp configuration files;
117 pure kernel executable (the operating system loaded into memory
120 loadable kernel modules;
124 empty directory commonly used by
125 system administrators as a temporary mount point
132 root's HOME directory
134 system programs and administration utilities
135 fundamental to both single-user and multi-user environments
137 programs used in a standalone environment
139 temporary files that are not guaranteed to persist across system reboots
141 contains the majority of user utilities and applications
143 .Bl -tag -width "libdata/" -compact
145 common utilities, programming tools, and applications
147 useful and semi-frivolous programs
149 standard C include files
151 .Bl -tag -width "cd9660/" -compact
153 C include files for Internet service protocols
155 C include files for the Common Access Methods Layer
156 .Bl -tag -width "cd9660/" -compact
158 The SCSI device on top of CAM
161 C include files for programming various
164 .Bl -tag -width "cd9660/" -compact
166 The parallel port bus;
173 .Bl -tag -width "cd9660/" -compact
178 GNU C++ include files
179 .Bl -tag -width "cd9660/" -compact
181 GNU C++ libstdc++ include files
184 ISC utility library libisc include files
186 .Bl -tag -width "cd9660/" -compact
191 C include files for libmilter,
192 the sendmail mail filter API
194 machine-specific C include files
198 misc network C include files
206 C include files for Internet standard protocols;
210 C include files for Internet protocol version 6;
214 IPX/SPX protocol stacks
216 kernel key-management service
226 C include files for NFS (Network File System)
228 Objective C include files
230 OpenSSL (Cryptography/SSL toolkit) headers
234 POSIX real-time extensions includes;
238 C include files for Berkeley service protocols
240 get a line from a user, with editing;
244 remote procedure calls;
248 definition of RPC service structures; see
256 library, part of Kerberos IV.
258 system C include files (kernel data structures)
263 .\" .Bl -tag -width "cd9660/" -compact
270 C include files for UFS (The U-word File System)
271 .Bl -tag -width "cd9660/" -compact
289 .Bl -tag -width Fl -compact
291 a.out archive libraries
293 shared libraries for compatibility
294 .Bl -tag -width Fl -compact
296 a.out backward compatibility libraries
301 misc. utility data files
302 .Bl -tag -width Fl -compact
304 files used by doscmd (drivers, fonts, etc.);
307 .Bl -tag -width 6n -compact
318 various prebuilt lint libraries;
322 Character set conversion tables
324 .Bl -tag -width Fl -compact
326 contains Perl modules for Perl version 5.00503;
331 holds the download firmware images
335 system daemons & system utilities (executed by other programs)
336 .Bl -tag -width Fl -compact
338 utilities to manipulate a.out executables
340 utilities to manipulate ELF executables
342 utilities and filters for LP print system;
352 restricted shell for sendmail;
362 local executables, libraries, etc.
363 Also used as the default destination for the
366 Within local/, the general layout sketched out by
369 should be used. Exceptions are the man directory (directly under local/
370 rather than under local/share/), ports documentation (in share/doc/<port>/),
371 and /usr/local/etc (mimics /etc).
373 architecture-specific target tree produced by building the /usr/src tree
377 ports collection (optional).
379 system daemons & system utilities (executed by users)
381 architecture-independent files
383 .Bl -tag -width "calendar/" -compact
385 a variety of pre-fab calendar files;
393 .Bl -tag -width Fl -compact
395 words from Webster's 2nd International
405 miscellaneous documentation;
406 source for most of the printed
412 .Bl -tag -width Fl -compact
414 Frequently Asked Questions
416 implementation notes for IPv6
418 documents pertaining to BIND (the Berkeley Internet Name Domain)
420 Spanish translations of documents in /usr/share/doc
425 Japanese translations of documents in /usr/share/doc
427 HTML documents pertaining to ncurses;
431 HTML documents pertaining to the Network Time Protocol
435 UNIX Programmer's Supplementary Documents
437 Russian translations of documents in /usr/share/doc
439 UNIX System Manager's Manual
444 UNIX User's Supplementary Documents
446 Chinese translations of documents in /usr/share/doc
450 various examples for users and programmers
452 ASCII text files used by various games
454 device description file for device name
456 GNU Info hypertext system
460 libg++'s genclass prototype/template class files
468 macros for use with the me macro package;
472 misc system-wide ASCII text files
473 .Bl -tag -width Fl -compact
481 terminal characteristics database;
490 national language support files;
494 pcvt documentation and etc examples;
502 sendmail configuration files;
506 example . (dot) files for new accounts
508 files used by syscons;
511 .Bl -tag -width "scrnmaps/xx" -compact
519 console keyboard maps;
528 tab description files for a variety of terminals; used in
533 text processing macros;
539 localization support and utilities for
542 timezone configuration information;
548 third-party, and/or local source files
550 .Bl -tag -width "contrib/" -compact
552 source code for files in /bin
554 source code for contributed software
556 source code for contributed cryptography software
558 source code for files in /etc
560 source code for files in /usr/games
562 Utilities covered by the GNU General Public License
564 source code for files in /usr/include
566 source code for kerberos version IV
568 source code for files in /usr/lib
570 source code for files in /usr/libexec
572 files required to produce a
576 source code for files in /sbin
578 build directory for files in /usr/src/crypto
580 source for files in /usr/share
584 tools used for maintenance and testing of
587 source code for files in /usr/bin
589 source code for files in /usr/sbin
593 X11R6 distribution executables, libraries, etc (optional).
594 .Bl -tag -width "include/" -compact
596 X11R6 binaries (servers, utilities, local packages/ports).
598 X11R6 configuration files and scripts.
606 architecture-independent files.
610 multi-purpose log, temporary, transient, and spool files
612 .Bl -tag -width "preserve/" -compact
614 system accounting files
616 .Bl -tag -width Fl -compact
618 execution accounting file;
624 timed command scheduling files;
627 .Bl -tag -width "preserve/" -compact
629 directory containing job files
631 directory containing output spool files
637 default directory to store kernel crash dumps; see
645 .Bl -tag -width "preserve/" -compact
653 misc. automatically generated system-specific database files
655 empty directory used by sshd(8) for privilege separation;
659 misc. game status and score files
661 kerberos server databases; see
664 misc. system log files
666 .Bl -tag -width Fl -compact
676 system messages database;
680 temporary home of files preserved after an accidental death
685 filesystem quota information files
687 system information files describing various info about
688 system since it was booted
690 .Bl -tag -width Fl -compact
694 group for command connection sockets; see
697 database of current users;
710 misc. printer and mail system spooling directories
712 .Bl -tag -width Fl -compact
714 undelivered submission mail queue;
718 commonly ~ftp; the anonymous ftp root directory
720 undelivered mail queue;
724 line printer spooling directories
728 commonly ~uucp; public uucp temporary directory
732 temporary files that are kept between system reboots
733 .Bl -tag -width Fl -compact
735 the directory where recovery files are stored
742 This manual page documents the default
744 filesystem layout, but
745 the actual hierarchy on a given system is defined at the system
746 administrator's discretion.
747 A well-maintained installation will include a customized version of
762 manual page appeared in