1.\" Copyright (c) 1990, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 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. 19.\" 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 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)hier.7 8.1 (Berkeley) 6/5/93 33.\" $FreeBSD$ 34.\" 35.Dd January 21, 2010 36.Dt HIER 7 37.Os 38.Sh NAME 39.Nm hier 40.Nd layout of file systems 41.Sh DESCRIPTION 42A sketch of the file system hierarchy. 43.Bl -tag -width ".Pa /libexec/" 44.It Pa / 45root directory of the file system 46.It Pa /bin/ 47user utilities fundamental to both single-user and multi-user environments 48.It Pa /boot/ 49programs and configuration files used during operating system bootstrap 50.Pp 51.Bl -tag -width ".Pa defaults/" -compact 52.It Pa defaults/ 53default bootstrapping configuration files; see 54.Xr loader.conf 5 55.It Pa kernel/ 56pure kernel executable (the operating system loaded into memory 57at boot time). 58.It Pa modules/ 59third-party loadable kernel modules; 60see 61.Xr kldstat 8 62.El 63.It Pa /cdrom/ 64default mount point for CD-ROM drives 65.It Pa /compat/ 66normally a link to 67.Pa /usr/compat . 68If not, then the 69.Pa /usr/compat 70comments apply 71.It Pa /dev/ 72device special files managed by 73.Xr devfs 5 74.Pp 75.Bl -tag -width ".Pa net/" -compact 76.It Pa fd/ 77file descriptor files; 78see 79.Xr \&fd 4 80.It Pa net/ 81network devices 82.El 83.It Pa /etc/ 84system configuration files and scripts 85.Pp 86.Bl -tag -width ".Pa bluetooth/" -compact 87.It Pa defaults/ 88default system configuration files; 89see 90.Xr rc 8 91.It Pa bluetooth/ 92bluetooth configuration files 93.It Pa gnats/ 94gnats configuration files; 95see 96.Xr send-pr 1 97.It Pa localtime 98local timezone information; 99see 100.Xr ctime 3 101.It Pa mail/ 102Sendmail control files 103.It Pa mtree/ 104mtree configuration files; 105see 106.Xr mtree 8 107.It Pa namedb/ 108named configuration files; 109see 110.Xr named 8 111.It Pa pam.d/ 112configuration files for the Pluggable Authentication Modules (PAM) 113library 114.It Pa periodic/ 115scripts that are run daily, weekly, and monthly, via 116.Xr cron 8 ; 117see 118.Xr periodic 8 119.It Pa rc.d/ 120System and daemon startup/control scripts; 121see 122.Xr rc 8 123.It Pa security/ 124OpenBSM audit configuration files; 125see 126.Xr audit 8 127.It Pa ppp/ 128ppp configuration files; 129see 130.Xr ppp 8 131.It Pa ssh/ 132OpenSSH configuration files; 133see 134.Xr ssh 1 135.It Pa ssl/ 136OpenSSL configuration files 137.El 138.It Pa /lib/ 139critical system libraries needed for binaries in 140.Pa /bin 141and 142.Pa /sbin 143.Pp 144.Bl -tag -width ".Pa geom/" -compact 145.It Pa geom/ 146class-specific libraries for the 147.Xr geom 8 148utility 149.El 150.It Pa /libexec/ 151critical system utilities needed for binaries in 152.Pa /bin 153and 154.Pa /sbin 155.It Pa /media/ 156contains subdirectories to be used as mount points 157for removable media such as CDs, USB drives, and 158floppy disks 159.It Pa /mnt/ 160empty directory commonly used by 161system administrators as a temporary mount point 162.It Pa /proc/ 163process file system; 164see 165.Xr procfs 5 166.It Pa /rescue/ 167statically linked programs for emergency recovery; 168see 169.Xr rescue 8 170.It Pa /root/ 171root's HOME directory 172.It Pa /sbin/ 173system programs and administration utilities 174fundamental to both single-user and multi-user environments 175.It Pa /tmp/ 176temporary files that are not guaranteed to persist across system reboots 177.It Pa /usr/ 178contains the majority of user utilities and applications 179.Pp 180.Bl -tag -width ".Pa libdata/" -compact 181.It Pa bin/ 182common utilities, programming tools, and applications 183.It Pa compat/ 184files needed to support binary compatibility with other operating systems, 185such as Linux 186.It Pa games/ 187useful and semi-frivolous programs 188.It Pa include/ 189standard C include files 190.Pp 191.Bl -tag -width ".Pa kerberos5/" -compact 192.It Pa altq/ 193C include files for alternate queueing 194.It Pa arpa/ 195C include files for Internet service protocols 196.It Pa bsnmp/ 197C include files for the SNMP daemon 198.It Pa c++/ 199C++ include files 200.It Pa cam/ 201C include files for the Common Access Methods Layer 202.Bl -tag -width ".Pa kerberos5/" -compact 203.It Pa scsi/ 204The SCSI device on top of CAM 205.El 206.It Pa dev/ 207C include files for programming various 208.Fx 209devices 210.Bl -tag -width ".Pa kerberos5/" -compact 211.It Pa ic/ 212Various header files describing driver- and bus-independent 213hardware circuits 214.It Pa ofw/ 215Open Firmware support 216.It Pa pbio/ 2178255 PPI cards; 218see 219.Xr pbio 4 220.It Pa ppbus/ 221The parallel port bus; 222see 223.Xr ppbus 4 224.It Pa usb/ 225The USB subsystem 226.It Pa utopia/ 227Physical chip driver for ATM interfaces; 228see 229.Xr utopia 4 230.It Pa wi/ 231The 232.Xr wi 4 233WaveLAN driver 234.El 235.It Pa fs/ 236.Bl -tag -width ".Pa kerberos5/" -compact 237.It Pa fdescfs/ 238per-process file descriptors file system 239.It Pa fifofs/ 240.St -p1003.1 241FIFOs file system 242.It Pa msdosfs/ 243MS-DOS file system 244.It Pa nfs/ 245C include files for NFS (Network File System) version 2, 3 and 4 246.It Pa nullfs/ 247loopback file system 248.It Pa procfs/ 249process file system 250.It Pa smbfs/ 251SMB/CIFS file system 252.It Pa udf/ 253UDF file system 254.It Pa unionfs 255union file system 256.El 257.It Pa geom/ 258GEOM framework 259.Bl -tag -width ".Pa kerberos5/" -compact 260.It Pa concat/ 261CONCAT GEOM class 262.It Pa gate/ 263GATE GEOM class 264.It Pa mirror/ 265MIRROR GEOM class 266.It Pa nop/ 267NOP GEOM class 268.It Pa raid3/ 269RAID3 GEOM class 270.It Pa stripe/ 271STRIPE GEOM class 272.El 273.Pp 274.It Pa isc/ 275ISC utility library libisc include files 276.It Pa isofs/ 277.Bl -tag -width ".Pa kerberos5/" -compact 278.It Pa cd9660/ 279iso9660 file system 280.El 281.It Pa libmilter/ 282C include files for libmilter, 283the 284.Xr sendmail 8 285mail filter API 286.It Pa machine/ 287machine-specific C include files 288.It Pa net/ 289miscellaneous network C include files 290.It Pa netatalk/ 291Appletalk protocol 292.It Pa netinet/ 293C include files for Internet standard protocols; 294see 295.Xr inet 4 296.It Pa netinet6/ 297C include files for Internet protocol version 6; 298see 299.Xr inet6 4 300.It Pa netipsec/ 301kernel key-management service; 302see 303.Xr ipsec 4 304.It Pa netipx/ 305IPX/SPX protocol stacks 306.It Pa netnatm/ 307NATM include files; 308see 309.Xr natm 4 310.Bl -tag -width ".Pa kerberos5/" -compact 311.It Pa api/ 312include files for the signalling API 313.It Pa msg/ 314include files that describe signalling messages and 315declare associated functions 316.It Pa saal/ 317include files for the signalling AAL layer 318.It Pa sig/ 319include files for the UNI signalling protocol 320.El 321.It Pa netsmb/ 322SMB/CIFS requester 323.It Pa nfs/ 324C include files for NFS (Network File System) version 2 and 3 (legacy) 325.It Pa objc/ 326Objective C include files 327.It Pa openssl/ 328OpenSSL (Cryptography/SSL toolkit) headers 329.It Pa pccard/ 330PC-CARD controllers 331.It Pa protocols/ 332C include files for Berkeley service protocols 333.It Pa readline/ 334get a line from a user, with editing; 335see 336.Xr readline 3 337.It Pa rpc/ 338remote procedure calls; 339see 340.Xr rpc 3 341.It Pa rpcsvc/ 342definition of RPC service structures; see 343.Xr rpc 3 344.It Pa security/ 345PAM; see 346.Xr pam 8 347.It Pa sys/ 348system C include files (kernel data structures) 349.\" .It Pa tcl/ 350.\" Tcl language; 351.\" see 352.\" .Xr Tcl n 353.\" .Bl -tag -width ".Pa kerberos5/" -compact 354.\" .It Pa generic/ 355.\" ??? 356.\" .It Pa unix/ 357.\" ??? 358.\" .El 359.It Pa ufs/ 360C include files for UFS (The U-word File System) 361.Bl -tag -width ".Pa kerberos5/" -compact 362.It Pa ffs/ 363Fast file system 364.It Pa ufs/ 365UFS file system 366.El 367.It Pa vm/ 368virtual memory; 369see 370.Xr vmstat 8 371.El 372.Pp 373.It Pa lib/ 374shared and archive 375.Xr ar 1 Ns -type 376libraries 377.Bl -tag -width Fl -compact 378.It Pa aout/ 379a.out archive libraries 380.It Pa compat/ 381shared libraries for compatibility 382.Bl -tag -width Fl -compact 383.It Pa aout/ 384a.out backward compatibility libraries 385.El 386.It Pa dtrace/ 387DTrace library scripts 388.It Pa engines/ 389OpenSSL (Cryptography/SSL toolkit) dynamically loadable engines 390.El 391.Pp 392.It Pa libdata/ 393miscellaneous utility data files 394.Bl -tag -width Fl -compact 395.It Pa gcc/ 396.Xr gcc 1 397configuration data 398.It Pa ldscripts/ 399linker scripts; 400see 401.Xr ld 1 402.It Pa lint/ 403various prebuilt lint libraries; 404see 405.Xr lint 1 406.El 407.Pp 408.It Pa libexec/ 409system daemons & system utilities (executed by other programs) 410.Bl -tag -width Fl -compact 411.It Pa aout/ 412utilities to manipulate a.out executables 413.It Pa elf/ 414utilities to manipulate ELF executables 415.It Pa lpr/ 416utilities and filters for LP print system; 417see 418.Xr lpr 1 419.It Pa sendmail/ 420the 421.Xr sendmail 8 422binary; 423see 424.Xr mailwrapper 8 425.It Pa sm.bin/ 426restricted shell for 427.Xr sendmail 8 ; 428see 429.Xr smrsh 8 430.El 431.Pp 432.It Pa local/ 433local executables, libraries, etc. 434Also used as the default destination for the 435.Fx 436ports framework. 437Within 438.Pa local/ , 439the general layout sketched out by 440.Nm 441for 442.Pa /usr 443should be used. 444Exceptions are the 445.Pa man 446directory 447.Po directly under 448.Pa local/ 449rather than under 450.Pa local/share/ Ns Pc , 451ports documentation 452.Po in 453.Pa share/doc/<port>/ Ns Pc , 454and 455.Pa /usr/local/etc 456.Po mimics 457.Pa /etc Ns Pc . 458.It Pa obj/ 459architecture-specific target tree produced by building the 460.Pa /usr/src 461tree 462.It Pa ports/ 463The 464.Fx 465ports collection (optional). 466.It Pa sbin/ 467system daemons & system utilities (executed by users) 468.It Pa share/ 469architecture-independent files 470.Pp 471.Bl -tag -width ".Pa calendar/" -compact 472.It Pa calendar/ 473a variety of pre-fab calendar files; 474see 475.Xr calendar 1 476.It Pa dict/ 477word lists; 478see 479.Xr look 1 480.Pp 481.Bl -tag -width Fl -compact 482.It Pa freebsd 483.Fx Ns -specific 484terms, proper names, and jargon 485.It Pa words 486common words 487.It Pa web2 488words from Webster's 2nd International 489.It Pa papers/ 490reference databases; 491see 492.Xr refer 1 493.El 494.Pp 495.It Pa doc/ 496miscellaneous documentation; 497source for most of the printed 498.Bx 499manuals (available 500from the 501.Tn USENIX 502association) 503.Bl -tag -width Fl -compact 504.It Pa FAQ/ 505Frequently Asked Questions 506.It Pa IPv6/ 507implementation notes for IPv6 508.It Pa bind/ 509documents pertaining to BIND (the Berkeley Internet Name Domain) 510.It Pa es/ 511Spanish translations of documents in /usr/share/doc 512.It Pa handbook/ 513.Fx 514Handbook 515.It Pa ja/ 516Japanese translations of documents in /usr/share/doc 517.It Pa legal/ 518License files for vendor supplied firmwares 519.It Pa ncurses/ 520HTML documents pertaining to ncurses; 521see 522.Xr ncurses 3 523.It Pa ntp/ 524HTML documents pertaining to the Network Time Protocol 525.It Pa papers/ 526UNIX Papers 527.It Pa psd/ 528UNIX Programmer's Supplementary Documents 529.It Pa ru/ 530Russian translations of documents in /usr/share/doc 531.It Pa smm/ 532UNIX System Manager's Manual 533.It Pa tutorials/ 534.Fx 535tutorials 536.It Pa usd/ 537UNIX User's Supplementary Documents 538.It Pa zh/ 539Chinese translations of documents in /usr/share/doc 540.El 541.Pp 542.It Pa examples/ 543various examples for users and programmers 544.It Pa games/ 545ASCII text files used by various games 546.It Pa groff_font/ 547device description file for device name 548.It Pa info/ 549GNU Info hypertext system 550.It Pa locale/ 551localization files; 552see 553.Xr setlocale 3 554.It Pa man/ 555manual pages 556.It Pa mdocml/ 557data files used by mdocml 558.It Pa me/ 559macros for use with the me macro package; 560see 561.Xr me 7 562.It Pa misc/ 563miscellaneous system-wide ASCII text files 564.Bl -tag -width Fl -compact 565.It Pa fonts/ 566??? 567.It Pa termcap 568terminal characteristics database; 569see 570.Xr termcap 5 571.El 572.It Pa mk/ 573templates for make; 574see 575.Xr make 1 576.It Pa nls/ 577national language support files; 578see 579.Xr mklocale 1 580.It Pa security/ 581data files for security policies such as 582.Xr mac_lomac 4 583.It Pa sendmail/ 584.Xr sendmail 8 585configuration files 586.It Pa skel/ 587example 588.Pa .\& 589(dot) files for new accounts 590.It Pa snmp/ 591MIBs, example files and tree definitions for the SNMP daemon. 592.Bl -tag -width Fl -compact 593.It Pa defs/ 594Tree definition files for use with 595.Xr gensnmptree 1 596.It Pa mibs/ 597MIB files 598.El 599.It Pa syscons/ 600files used by syscons; 601see 602.Xr syscons 4 603.Bl -tag -width ".Pa scrnmaps/" -compact 604.It Pa fonts/ 605console fonts; 606see 607.Xr vidcontrol 1 608and 609.Xr vidfont 1 610.It Pa keymaps/ 611console keyboard maps; 612see 613.Xr kbdcontrol 1 614and 615.Xr kbdmap 1 616.It Pa scrnmaps/ 617console screen maps 618.El 619.It Pa tabset/ 620tab description files for a variety of terminals; used in 621the termcap file; 622see 623.Xr termcap 5 624.It Pa tmac/ 625text processing macros; 626see 627.Xr nroff 1 628and 629.Xr troff 1 630.It Pa vi/ 631localization support and utilities for 632.Xr vi 1 633.It Pa zoneinfo/ 634timezone configuration information; 635see 636.Xr tzfile 5 637.El 638.It Pa src/ 639.Bx , 640third-party, and/or local source files 641.Pp 642.Bl -tag -width ".Pa kerberos5/" -compact 643.It Pa bin/ 644source code for files in /bin 645.It Pa cddl/ 646Utilities covered by the Common Development and Distribution License 647.It Pa contrib/ 648source code for contributed software 649.It Pa crypto/ 650source code for contributed cryptography software 651.It Pa etc/ 652source code for files in 653.Pa /etc 654.It Pa games/ 655source code for files in 656.Pa /usr/games 657.It Pa gnu/ 658Utilities covered by the GNU General Public License 659.It Pa include/ 660source code for files in 661.Pa /usr/include 662.It Pa kerberos5/ 663build infrastructure for kerberos version 5 664.It Pa lib/ 665source code for files in 666.Pa /usr/lib 667.It Pa libexec/ 668source code for files in 669.Pa /usr/libexec 670.It Pa release/ 671files required to produce a 672.Fx 673release 674.It Pa sbin/ 675source code for files in 676.Pa /sbin 677.It Pa secure/ 678build directory for files in 679.Pa /usr/src/crypto 680.It Pa share/ 681source for files in 682.Pa /usr/share 683.It Pa sys/ 684kernel source code 685.It Pa tools/ 686tools used for maintenance and testing of 687.Fx 688.It Pa usr.bin/ 689source code for files in 690.Pa /usr/bin 691.It Pa usr.sbin/ 692source code for files in 693.Pa /usr/sbin 694.El 695.El 696.It Pa /var/ 697multi-purpose log, temporary, transient, and spool files 698.Pp 699.Bl -tag -width ".Pa preserve/" -compact 700.It Pa account/ 701system accounting files 702.Pp 703.Bl -tag -width Fl -compact 704.It Pa acct 705execution accounting file; 706see 707.Xr acct 5 708.El 709.Pp 710.It Pa at/ 711timed command scheduling files; 712see 713.Xr \&at 1 714.Bl -tag -width ".Pa preserve/" -compact 715.It Pa jobs/ 716directory containing job files 717.It Pa spool/ 718directory containing output spool files 719.El 720.Pp 721.It Pa backups/ 722miscellaneous backup files 723.It Pa crash/ 724default directory to store kernel crash dumps; see 725.Xr crash 8 726and 727.Xr savecore 8 728.It Pa cron/ 729files used by cron; 730see 731.Xr cron 8 732.Bl -tag -width ".Pa preserve/" -compact 733.It Pa tabs/ 734crontab files; 735see 736.Xr crontab 5 737.El 738.Pp 739.It Pa db/ 740miscellaneous automatically generated system-specific database files 741.It Pa empty/ 742empty directory for use by programs that need a specifically empty directory. 743Used for instance by 744.Xr sshd 8 745for privilege separation. 746.It Pa games/ 747miscellaneous game status and score files 748.It Pa heimdal/ 749kerberos server databases; see 750.Xr kdc 8 751.It Pa log/ 752miscellaneous system log files 753.Pp 754.Bl -tag -width Fl -compact 755.It Pa utx.lastlogin 756last login log; 757see 758.Xr getutxent 3 759.It Pa utx.log 760login/logout log; 761see 762.Xr getutxent 3 763.El 764.Pp 765.It Pa mail/ 766user mailbox files 767.It Pa msgs/ 768system messages database; 769see 770.Xr msgs 1 771.It Pa preserve/ 772temporary home of files preserved after an accidental death 773of an editor; 774see 775.Xr \&ex 1 776.It Pa quotas/ 777file system quota information files 778.It Pa run/ 779system information files describing various info about 780system since it was booted 781.Pp 782.Bl -tag -width Fl -compact 783.It Pa named/ 784writable by the 785.Dq bind 786user; see 787.Xr named 8 788.It Pa ppp/ 789writable by the 790.Dq network 791group for command connection sockets; see 792.Xr ppp 8 793.It Pa utx.active 794database of current users; 795see 796.Xr getutxent 3 797.El 798.Pp 799.It Pa rwho/ 800rwho data files; 801see 802.Xr rwhod 8 , 803.Xr rwho 1 , 804and 805.Xr ruptime 1 806.It Pa spool/ 807miscellaneous printer and mail system spooling directories 808.Pp 809.Bl -tag -width Fl -compact 810.It Pa clientmqueue/ 811undelivered submission mail queue; 812see 813.Xr sendmail 8 814.It Pa ftp/ 815commonly ~ftp; the anonymous ftp root directory 816.It Pa mqueue/ 817undelivered mail queue; 818see 819.Xr sendmail 8 820.It Pa output/ 821line printer spooling directories 822.El 823.Pp 824.It Pa tmp/ 825temporary files that are kept between system reboots 826.Bl -tag -width Fl -compact 827.It Pa vi.recover/ 828the directory where recovery files are stored 829.El 830.It Pa yp/ 831the NIS maps 832.El 833.El 834.Sh NOTES 835This manual page documents the default 836.Fx 837file system layout, but 838the actual hierarchy on a given system is defined at the system 839administrator's discretion. 840A well-maintained installation will include a customized version of 841this document. 842.Sh SEE ALSO 843.Xr apropos 1 , 844.Xr find 1 , 845.Xr finger 1 , 846.Xr grep 1 , 847.Xr ls 1 , 848.Xr whatis 1 , 849.Xr whereis 1 , 850.Xr which 1 , 851.Xr fd 4 , 852.Xr devfs 5 , 853.Xr fsck 8 854.Sh HISTORY 855A 856.Nm 857manual page appeared in 858.At v7 . 859