share/man/man7/hier.7

   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. Neither the name of the University nor the names of its contributors
  13 .\"    may be used to endorse or promote products derived from this software
  14 .\"    without specific prior written permission.
  15 .\"
  16 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  26 .\" SUCH DAMAGE.
  27 .\"
  28 .\"     @(#)hier.7      8.1 (Berkeley) 6/5/93
  29 .\" $FreeBSD: src/share/man/man7/hier.7,v 1.29.2.17 2003/01/13 21:43:50 ceri Exp $
  30 .\"
  31 .Dd May 23, 2013
  32 .Dt HIER 7
  33 .Os
  34 .Sh NAME
  35 .Nm hier
  36 .Nd layout of filesystems
  37 .Sh DESCRIPTION
  38 A sketch of the filesystem hierarchy.
  39 .Bl -tag -width ".Pa /modules/"
  40 .It Pa /
  41 root directory of the filesystem
  42 .It Pa /bin/
  43 user utilities fundamental to both single-user and multi-user environments
  44 .It Pa /boot/
  45 programs and configuration files used during operating system bootstrap
  46 .Pp
  47 .Bl -tag -width ".Pa defaults/" -compact
  48 .It Pa defaults/
  49 default bootstrapping configuration files; see
  50 .Xr loader.conf 5
  51 .It Pa kernel/
  52 pure kernel executable (the operating system loaded into memory
  53 at boot time) and loadable kernel modules;
  54 see
  55 .Xr kldstat 8
  56 .El
  57 .It Pa /dev/
  58 block and character device files
  59 .Pp
  60 .Bl -tag -width ".Pa fd/" -compact
  61 .It Pa fd/
  62 file descriptor files;
  63 see
  64 .Xr \&fd 4
  65 .El
  66 .It Pa /etc/
  67 system configuration files and scripts
  68 .Pp
  69 .Bl -tag -width ".Pa bluetooth/" -compact
  70 .It Pa bluetooth/
  71 bluetooth configuration files
  72 .It Pa defaults/
  73 default system configuration files;
  74 see
  75 .Xr rc 8
  76 .It Pa dma/
  77 .Xr dma 8
  78 configuration files
  79 .\".It Pa firmware/
  80 .\"Firmware image files;
  81 .\"see
  82 .\".Xr firmware 9
  83 .It Pa localtime
  84 local timezone information;
  85 see
  86 .Xr ctime 3
  87 .It Pa mail/
  88 Sendmail control files
  89 .It Pa mtree/
  90 mtree configuration files;
  91 see
  92 .Xr mtree 8
  93 .It Pa pam.d/
  94 configuration files for the Pluggable Authentication Modules (PAM)
  95 library
  96 .It Pa periodic/
  97 scripts that are run daily, weekly, and monthly, via
  98 .Xr cron 8 ;
  99 see
 100 .Xr periodic 8
 101 .It Pa ppp/
 102 ppp configuration files;
 103 see
 104 .Xr ppp 8
 105 .It Pa rc.d/
 106 System and daemon startup/control scripts;
 107 see
 108 .Xr rc 8
 109 .It Pa ssh/
 110 OpenSSH configuration files;
 111 see
 112 .Xr ssh 1
 113 .It Pa ssl/
 114 OpenSSL configuration files
 115 .It Pa upgrade/
 116 Files relevant to system upgrades
 117 .It Pa uucp/
 118 uucp configuration files;
 119 see
 120 .Xr uucp 1
 121 .El
 122 .It Pa /home/
 123 HOME directories of non-root users
 124 .It Pa /mnt/
 125 empty directory commonly used by
 126 system administrators as a temporary mount point
 127 .It Pa /pfs/
 128 pseudo file system directory (on
 129 .Xr hammer 5
 130 root file systems)
 131 .It Pa /proc/
 132 process file system;
 133 see
 134 .Xr procfs 5 ,
 135 .Xr mount_procfs 8
 136 .It Pa /root/
 137 root's HOME directory
 138 .It Pa /sbin/
 139 system programs and administration utilities
 140 fundamental to both single-user and multi-user environments
 141 .It Pa /sys/
 142 the kernel's source code (usually a symbolic link to
 143 .Pa /usr/src/sys )
 144 .It Pa /tmp/
 145 temporary files that are not guaranteed to persist across system reboots
 146 .It Pa /usr/
 147 contains the majority of user utilities and applications
 148 .Pp
 149 .Bl -tag -width ".Pa libdata/" -compact
 150 .It Pa bin/
 151 common utilities, programming tools, and applications
 152 .It Pa dports/
 153 The
 154 .Dx
 155 .Xr dports 7
 156 collection (optional).
 157 .It Pa games/
 158 useful and semi-frivolous programs
 159 .It Pa include/
 160 standard C include files
 161 .Pp
 162 .Bl -tag -width ".Pa libmilter/" -compact
 163 .It Pa arpa/
 164 C include files for Internet service protocols
 165 .It Pa c++/
 166 C++ include files
 167 .It Pa cam/
 168 C include files for the Common Access Methods Layer
 169 .Pp
 170 .Bl -tag -width ".Pa scsi/" -compact
 171 .It Pa scsi/
 172 The SCSI device on top of CAM
 173 .El
 174 .Pp
 175 .It Pa dev/
 176 C include files for programming various
 177 .Dx
 178 devices
 179 .It Pa emulation/
 180 Include Files for various emulation layers
 181 .It Pa fs/
 182 .Pp
 183 .Bl -tag -width ".Pa smbfs/" -compact
 184 .It Pa smbfs/
 185 SMB/CIFS filesystem
 186 .El
 187 .Pp
 188 .It Pa isofs/
 189 .Pp
 190 .Bl -tag -width ".Pa cd9660/" -compact
 191 .It Pa cd9660/
 192 iso9660 filesystem
 193 .El
 194 .Pp
 195 .It Pa libmilter/
 196 C include files for libmilter,
 197 the sendmail mail filter API
 198 .It Pa libprop/
 199 C include files for libprop
 200 .It Pa machine/
 201 machine-specific C include files
 202 .It Pa msdosfs/
 203 MS-DOS file system
 204 .It Pa net/
 205 misc network C include files
 206 .It Pa netatm/
 207 ATM include files;
 208 see
 209 .Xr atm 8
 210 .It Pa netinet/
 211 C include files for Internet standard protocols;
 212 see
 213 .Xr inet 4
 214 .It Pa netinet6/
 215 C include files for Internet protocol version 6;
 216 see
 217 .Xr inet6 4
 218 .It Pa netipx/
 219 IPX/SPX protocol stacks
 220 .It Pa netkey/
 221 kernel key-management service
 222 .It Pa netnatm/
 223 NATM include files;
 224 see
 225 .Xr natm 4
 226 .It Pa netsmb/
 227 SMB/CIFS requester
 228 .It Pa nfs/
 229 C include files for NFS (Network File System)
 230 .It Pa openssl/
 231 OpenSSL (Cryptography/SSL toolkit) headers
 232 .It Pa pcap/
 233 Packet Capture (libpcap) headers;
 234 see
 235 .Xr pcap 3
 236 .It Pa pccard/
 237 PC-CARD controllers
 238 .It Pa protocols/
 239 C include files for Berkeley service protocols
 240 .It Pa readline/
 241 get a line from a user, with editing;
 242 see
 243 .Xr readline 3
 244 .It Pa rpc/
 245 remote procedure calls;
 246 see
 247 .Xr rpc 3
 248 .It Pa rpcsvc/
 249 definition of RPC service structures; see
 250 .Xr rpc 3
 251 .It Pa security/
 252 PAM; see
 253 .Xr pam 8
 254 .It Pa sys/
 255 system C include files (kernel data structures)
 256 .It Pa ufs/
 257 C include files for UFS (The U-word File System)
 258 .Pp
 259 .Bl -tag -width ".Pa ffs/" -compact
 260 .It Pa ffs/
 261 Fast filesystem
 262 .It Pa mfs/
 263 memory file system;
 264 see
 265 .Xr mount_mfs 8
 266 .It Pa ufs/
 267 UFS filesystem
 268 .El
 269 .Pp
 270 .It Pa vm/
 271 virtual memory;
 272 see
 273 .Xr vmstat 8
 274 .El
 275 .Pp
 276 .It Pa lib/
 277 archive libraries
 278 .Pp
 279 .Bl -tag -width ".Pa compat/" -compact
 280 .It Pa aout/
 281 a.out archive libraries
 282 .It Pa compat/
 283 shared libraries for compatibility
 284 .Pp
 285 .Bl -tag -width ".Pa aout/" -compact
 286 .It Pa aout/
 287 a.out backward compatibility libraries
 288 .El
 289 .It Pa engines/
 290 OpenSSL dynamic engines
 291 .El
 292 .Pp
 293 .It Pa libdata/
 294 misc. utility data files
 295 .It Pa libexec/
 296 system daemons & system utilities (executed by other programs)
 297 .Pp
 298 .Bl -tag -width ".Pa binutils221/" -compact
 299 .It Pa binutils221/
 300 .Pp
 301 .Bl -tag -width ".Pa ldscripts/" -compact
 302 .It Pa ldscripts/
 303 linker scripts;
 304 see
 305 .Xr ld 1
 306 .El
 307 .Pp
 308 .It Pa binutils222/
 309 .Pp
 310 .Bl -tag -width ".Pa ldscripts/" -compact
 311 .It Pa ldscripts/
 312 linker scripts;
 313 see
 314 .Xr ld 1
 315 .El
 316 .Pp
 317 .It Pa lpr/
 318 utilities and filters for LP print system;
 319 see
 320 .Xr lpr 1
 321 .It Pa sendmail/
 322 the sendmail binary;
 323 see
 324 .Xr mailwrapper 8
 325 and
 326 .Xr sendmail 8
 327 .It Pa sm.bin/
 328 restricted shell for sendmail;
 329 see
 330 .Xr smrsh 8
 331 .It Pa uucp/
 332 uucp utilities;
 333 see
 334 .Xr uucp 1
 335 .El
 336 .Pp
 337 .It Pa local/
 338 local executables, libraries, etc.
 339 Also used as the default destination for the
 340 .Dx
 341 .Xr dports 7
 342 framework.
 343 Within
 344 .Pa local/ ,
 345 the general layout sketched out by
 346 .Nm
 347 for
 348 .Pa /usr
 349 should be used.
 350 Exceptions are the
 351 .Pa man
 352 directory
 353 .Po directly under
 354 .Pa local/
 355 rather than under
 356 .Pa local/share/ Ns Pc ,
 357 ports documentation
 358 .Po in
 359 .Pa share/doc/<port>/ Ns Pc ,
 360 and
 361 .Pa /usr/local/etc
 362 .Po mimics
 363 .Pa /etc Ns Pc .
 364 .It Pa obj/
 365 architecture-specific target tree produced by building the
 366 .Pa /usr/src
 367 tree
 368 .It Pa pkg/
 369 default destination directory for the
 370 .Xr pkgsrc 7
 371 collection.
 372 Within
 373 .Pa pkg/ ,
 374 the general layout sketched out by
 375 .Xr hier 7
 376 for
 377 .Pa /usr
 378 should be used.
 379 Exceptions are the
 380 .Pa man/
 381 directory (directly under
 382 .Pa pkg/
 383 rather than under
 384 .Pa pkg/share/ ) ,
 385 documentation (in
 386 .Pa share/doc/<pkg>/ ) ,
 387 and
 388 .Pa /usr/pkg/etc
 389 .Pf ( mimics
 390 .Pa /etc ) .
 391 .It Pa pkgsrc/
 392 The
 393 .Xr pkgsrc 7
 394 collection (optional).
 395 .It Pa sbin/
 396 system daemons & system utilities (executed by users)
 397 .It Pa share/
 398 architecture-independent files
 399 .Pp
 400 .Bl -tag -width ".Pa groff_font/" -compact
 401 .It Pa calendar/
 402 a variety of pre-fab calendar files;
 403 see
 404 .Xr calendar 1
 405 .It Pa dict/
 406 word lists;
 407 see
 408 .Xr look 1
 409 .Pp
 410 .Bl -tag -width ".Pa papers/" -compact
 411 .It Pa web2
 412 words from Webster's 2nd International
 413 .It Pa words
 414 common words
 415 .It Pa papers/
 416 reference databases;
 417 see
 418 .Xr refer 1
 419 .El
 420 .Pp
 421 .It Pa doc/
 422 miscellaneous documentation
 423 .Bl -tag -width ".Pa legal/" -compact
 424 .It Pa legal/
 425 License files for vendor supplied firmware
 426 .El
 427 .Pp
 428 .It Pa examples/
 429 various examples for users and programmers
 430 .It Pa games/
 431 ASCII text files used by various games
 432 .It Pa groff_font/
 433 device description file for device name
 434 .It Pa i18n/
 435 internationalization databases; see
 436 .Xr iconv 3
 437 .It Pa info/
 438 GNU Info hypertext system
 439 .It Pa libg++/
 440 libg++'s genclass prototype/template class files
 441 .It Pa locale/
 442 localization files;
 443 see
 444 .Xr setlocale 3
 445 .It Pa man/
 446 manual pages
 447 .It Pa me/
 448 macros for use with the me macro package;
 449 see
 450 .Xr me 7
 451 .It Pa misc/
 452 misc system-wide ASCII text files
 453 .Pp
 454 .Bl -tag -width ".Pa termcap" -compact
 455 .It Pa termcap
 456 terminal characteristics database;
 457 see
 458 .Xr termcap 5
 459 .El
 460 .Pp
 461 .It Pa mk/
 462 templates for make;
 463 see
 464 .Xr make 1
 465 .It Pa nls/
 466 national language support files;
 467 see
 468 .Xr mklocale 1
 469 .It Pa openssl/
 470 .Pp
 471 .Bl -tag -width ".Pa man/" -compact
 472 .It Pa man/
 473 OpenSSL manual pages
 474 .El
 475 .Pp
 476 .It Pa sendmail/
 477 sendmail configuration files;
 478 see
 479 .Xr sendmail 8
 480 .It Pa skel/
 481 example . (dot) files for new accounts
 482 .It Pa syscons/
 483 files used by
 484 .Xr syscons 4
 485 .Pp
 486 .Bl -tag -width ".Pa scrnmaps/" -compact
 487 .It Pa fonts/
 488 console fonts;
 489 see
 490 .Xr vidcontrol 1
 491 and
 492 .Xr vidfont 1
 493 .It Pa keymaps/
 494 console keyboard maps;
 495 see
 496 .Xr kbdcontrol 1
 497 and
 498 .Xr kbdmap 1
 499 .It Pa scrnmaps/
 500 console screen maps
 501 .El
 502 .Pp
 503 .It Pa tabset/
 504 tab description files for a variety of terminals; used in
 505 the termcap file;
 506 see
 507 .Xr termcap 5
 508 .It Pa terminfo/
 509 compiled
 510 .Xr terminfo 5
 511 database files
 512 .It Pa tmac/
 513 text processing macros;
 514 see
 515 .Xr nroff 1
 516 and
 517 .Xr troff 1
 518 .It Pa vi/
 519 localization support and utilities for
 520 .Xr vi 1
 521 .It Pa zoneinfo/
 522 timezone configuration information;
 523 see
 524 .Xr tzfile 5
 525 .El
 526 .Pp
 527 .It Pa src/
 528 .Bx ,
 529 third-party, and/or local source files
 530 .Pp
 531 .Bl -tag -width ".Pa nrelease/" -compact
 532 .It Pa bin/
 533 source code for files in
 534 .Pa /bin
 535 .It Pa contrib/
 536 source code for contributed software
 537 .It Pa crypto/
 538 source code for contributed cryptography software
 539 .It Pa etc/
 540 source code for files in
 541 .Pa /etc
 542 .It Pa games/
 543 source code for files in
 544 .Pa /usr/games
 545 .It Pa gnu/
 546 Utilities covered by the GNU General Public License
 547 .It Pa include/
 548 source code for files in
 549 .Pa /usr/include
 550 .It Pa lib/
 551 source code for files in
 552 .Pa /usr/lib
 553 .It Pa libexec/
 554 source code for files in
 555 .Pa /usr/libexec
 556 .It Pa nrelease/
 557 files required to produce a
 558 .Dx
 559 release
 560 .It Pa sbin/
 561 source code for files in
 562 .Pa /sbin
 563 .It Pa secure/
 564 build directory for files in
 565 .Pa /usr/src/crypto
 566 .It Pa share/
 567 source for files in
 568 .Pa /usr/share
 569 .It Pa sys/
 570 kernel source code
 571 .It Pa tools/
 572 tools used for maintenance and testing of
 573 .Dx
 574 .It Pa usr.bin/
 575 source code for files in
 576 .Pa /usr/bin
 577 .It Pa usr.sbin/
 578 source code for files in
 579 .Pa /usr/sbin
 580 .El
 581 .El
 582 .It Pa /var/
 583 multi-purpose log, temporary, transient, and spool files
 584 .Pp
 585 .Bl -tag -width ".Pa preserve/" -compact
 586 .It Pa account/
 587 system accounting files
 588 .Pp
 589 .Bl -tag -width ".Pa acct" -compact
 590 .It Pa acct
 591 execution accounting file;
 592 see
 593 .Xr acct 5
 594 .El
 595 .Pp
 596 .It Pa at/
 597 timed command scheduling files;
 598 see
 599 .Xr \&at 1
 600 .Pp
 601 .Bl -tag -width ".Pa spool/" -compact
 602 .It Pa jobs/
 603 directory containing job files
 604 .It Pa spool/
 605 directory containing output spool files
 606 .El
 607 .Pp
 608 .It Pa backups/
 609 misc. backup files
 610 .It Pa crash/
 611 default directory to store kernel crash dumps; see
 612 .Xr crash 8
 613 and
 614 .Xr savecore 8
 615 .It Pa cron/
 616 files used by cron;
 617 see
 618 .Xr cron 8
 619 .Pp
 620 .Bl -tag -width ".Pa tabs/" -compact
 621 .It Pa tabs/
 622 crontab files;
 623 see
 624 .Xr crontab 5
 625 .El
 626 .Pp
 627 .It Pa db/
 628 misc. automatically generated system-specific database files
 629 .It Pa empty/
 630 empty directory used by
 631 .Xr sshd 8
 632 for privilege separation
 633 .It Pa games/
 634 misc. game status and score files
 635 .It Pa hammer/
 636 per PFS (pseudo file system) snapshots directory for
 637 .Xr hammer 5
 638 file systems
 639 .It Pa log/
 640 misc. system log files
 641 .Pp
 642 .Bl -tag -width ".Pa wtmp" -compact
 643 .It Pa wtmp
 644 login/logout log;
 645 see
 646 .Xr wtmp 5
 647 .El
 648 .Pp
 649 .It Pa mail/
 650 user mailbox files
 651 .It Pa msgs/
 652 system messages database;
 653 see
 654 .Xr msgs 1
 655 .It Pa preserve/
 656 temporary home of files preserved after an accidental death
 657 of an editor;
 658 see
 659 .Xr \&ex 1
 660 .It Pa quotas/
 661 filesystem quota information files
 662 .It Pa run/
 663 system information files describing various info about
 664 system since it was booted
 665 .Pp
 666 .Bl -tag -width ".Pa ppp/" -compact
 667 .It Pa ppp/
 668 writable by the
 669 .Dq network
 670 group for command connection sockets; see
 671 .Xr ppp 8
 672 .It Pa utmp
 673 database of current users;
 674 see
 675 .Xr utmp 5
 676 .El
 677 .Pp
 678 .It Pa rwho/
 679 rwho data files;
 680 see
 681 .Xr rwhod 8 ,
 682 .Xr rwho 1 ,
 683 and
 684 .Xr ruptime 1
 685 .It Pa spool/
 686 misc. printer and mail system spooling directories
 687 .Pp
 688 .Bl -tag -width ".Pa clientmqueue/" -compact
 689 .It Pa clientmqueue/
 690 undelivered submission mail queue;
 691 see
 692 .Xr sendmail 8
 693 .It Pa dma/
 694 undelivered mail queue;
 695 see
 696 .Xr dma 8
 697 .It Pa ftp/
 698 commonly
 699 .Pa ~ftp ;
 700 the anonymous ftp root directory
 701 .It Pa mqueue/
 702 undelivered mail queue;
 703 see
 704 .Xr sendmail 8
 705 .It Pa output/
 706 line printer spooling directories
 707 .It Pa uucp/
 708 uucp spool directory
 709 .It Pa uucppublic/
 710 commonly
 711 .Pa ~uucp ;
 712 public uucp temporary directory
 713 .El
 714 .Pp
 715 .It Pa tmp/
 716 temporary files that are kept between system reboots
 717 .Pp
 718 .Bl -tag -width ".Pa vi.recover/" -compact
 719 .It Pa vi.recover/
 720 the directory where recovery files are stored
 721 .El
 722 .Pp
 723 .It Pa yp/
 724 the NIS maps
 725 .El
 726 .El
 727 .Sh NOTES
 728 This manual page documents the default
 729 .Dx
 730 filesystem layout, but
 731 the actual hierarchy on a given system is defined at the system
 732 administrator's discretion.
 733 A well-maintained installation will include a customized version of
 734 this document.
 735 .Sh SEE ALSO
 736 .Xr apropos 1 ,
 737 .Xr find 1 ,
 738 .Xr finger 1 ,
 739 .Xr grep 1 ,
 740 .Xr ls 1 ,
 741 .Xr whatis 1 ,
 742 .Xr whereis 1 ,
 743 .Xr which 1 ,
 744 .Xr fsck 8
 745 .Sh HISTORY
 746 A
 747 .Nm
 748 manual page appeared in
 749 .At v7 .