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 November 6, 2016
  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 modules.local/" -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 .It Pa modules.local/
  57 local loadable kernel modules and wrapped external firmware images; see
  58 .Xr firmware 9
  59 .El
  60 .It Pa /compat/
  61 files related to compatibility layers
  62 .Pp
  63 .Bl -tag -width ".Pa ndis/" -compact
  64 .It Pa ndis/
  65 firmware for
  66 .Xr ndis 4
  67 drivers
  68 .El
  69 .It Pa /dev/
  70 block and character device files
  71 .Pp
  72 .Bl -tag -width ".Pa fd/" -compact
  73 .It Pa fd/
  74 file descriptor files;
  75 see
  76 .Xr \&fd 4
  77 .El
  78 .It Pa /etc/
  79 system configuration files and scripts
  80 .Pp
  81 .Bl -tag -width ".Pa bluetooth/" -compact
  82 .It Pa bluetooth/
  83 bluetooth configuration files
  84 .It Pa defaults/
  85 default system configuration files;
  86 see
  87 .Xr rc 8
  88 .It Pa devd/
  89 hardware specific
  90 .Xr devd 8
  91 configuration files
  92 .It Pa dma/
  93 .Xr dma 8
  94 configuration files
  95 .It Pa localtime
  96 local timezone information;
  97 see
  98 .Xr ctime 3
  99 .It Pa mail/
 100 Sendmail control files
 101 .It Pa mtree/
 102 mtree configuration files;
 103 see
 104 .Xr mtree 8
 105 .It Pa pam.d/
 106 configuration files for the Pluggable Authentication Modules (PAM)
 107 library
 108 .It Pa periodic/
 109 scripts that are run daily, weekly, and monthly, via
 110 .Xr cron 8 ;
 111 see
 112 .Xr periodic 8
 113 .It Pa ppp/
 114 ppp configuration files;
 115 see
 116 .Xr ppp 8
 117 .It Pa rc.d/
 118 System and daemon startup/control scripts;
 119 see
 120 .Xr rc 8
 121 .It Pa ssh/
 122 OpenSSH configuration files;
 123 see
 124 .Xr ssh 1
 125 .It Pa ssl/
 126 OpenSSL configuration files
 127 .It Pa upgrade/
 128 Files relevant to system upgrades
 129 .It Pa uucp/
 130 uucp configuration files;
 131 see
 132 .Xr uucp 1
 133 .El
 134 .It Pa /home/
 135 HOME directories of non-root users
 136 .It Pa /lib/
 137 critical system libraries needed for binaries in
 138 .Pa /bin
 139 and
 140 .Pa /sbin
 141 .It Pa /libexec/
 142 critical system utilities needed for binaries in
 143 .Pa /bin
 144 and
 145 .Pa /sbin
 146 .It Pa /mnt/
 147 empty directory commonly used by
 148 system administrators as a temporary mount point
 149 .It Pa /net/
 150 automounted NFS shares;
 151 see
 152 .Xr auto_master 5
 153 .It Pa /pfs/
 154 pseudo file system directory (on
 155 .Xr hammer 5
 156 root file systems)
 157 .It Pa /proc/
 158 process file system;
 159 see
 160 .Xr procfs 5 ,
 161 .Xr mount_procfs 8
 162 .It Pa /root/
 163 root's HOME directory
 164 .It Pa /sbin/
 165 system programs and administration utilities
 166 fundamental to both single-user and multi-user environments
 167 .It Pa /sys/
 168 the kernel's source code (usually a symbolic link to
 169 .Pa /usr/src/sys )
 170 .It Pa /tmp/
 171 temporary files that are not guaranteed to persist across system reboots
 172 .It Pa /usr/
 173 contains the majority of user utilities and applications
 174 .Pp
 175 .Bl -tag -width ".Pa libdata/" -compact
 176 .It Pa bin/
 177 common utilities, programming tools, and applications
 178 .It Pa dports/
 179 The
 180 .Dx
 181 .Xr dports 7
 182 collection (optional).
 183 .It Pa games/
 184 useful and semi-frivolous programs
 185 .It Pa include/
 186 standard C include files
 187 .Pp
 188 .Bl -tag -width ".Pa protocols/" -compact
 189 .It Pa arpa/
 190 C include files for Internet service protocols
 191 .It Pa c++/
 192 C++ include files
 193 .It Pa cam/
 194 C include files for the Common Access Methods Layer
 195 .Pp
 196 .Bl -tag -width ".Pa scsi/" -compact
 197 .It Pa scsi/
 198 The SCSI device on top of CAM
 199 .El
 200 .Pp
 201 .It Pa dev/
 202 C include files for programming various
 203 .Dx
 204 devices
 205 .It Pa emulation/
 206 Include Files for various emulation layers
 207 .It Pa fs/
 208 .Pp
 209 .Bl -tag -width ".Pa smbfs/" -compact
 210 .It Pa smbfs/
 211 SMB/CIFS filesystem
 212 .El
 213 .Pp
 214 .It Pa isofs/
 215 .Pp
 216 .Bl -tag -width ".Pa cd9660/" -compact
 217 .It Pa cd9660/
 218 iso9660 filesystem
 219 .El
 220 .Pp
 221 .It Pa libprop/
 222 C include files for libprop
 223 .It Pa machine/
 224 machine-specific C include files
 225 .It Pa msdosfs/
 226 MS-DOS file system
 227 .It Pa net/
 228 misc network C include files
 229 .It Pa netinet/
 230 C include files for Internet standard protocols;
 231 see
 232 .Xr inet 4
 233 .It Pa netinet6/
 234 C include files for Internet protocol version 6;
 235 see
 236 .Xr inet6 4
 237 .It Pa netkey/
 238 kernel key-management service
 239 .It Pa netsmb/
 240 SMB/CIFS requester
 241 .It Pa nfs/
 242 C include files for NFS (Network File System)
 243 .It Pa openssl/
 244 OpenSSL (Cryptography/SSL toolkit) headers
 245 .It Pa pcap/
 246 Packet Capture (libpcap) headers;
 247 see
 248 .Xr pcap 3
 249 .It Pa pccard/
 250 PC-CARD controllers
 251 .It Pa protocols/
 252 C include files for Berkeley service protocols
 253 .It Pa readline/
 254 get a line from a user, with editing;
 255 see
 256 .Xr readline 3
 257 .It Pa rpc/
 258 remote procedure calls;
 259 see
 260 .Xr rpc 3
 261 .It Pa rpcsvc/
 262 definition of RPC service structures; see
 263 .Xr rpc 3
 264 .It Pa security/
 265 PAM; see
 266 .Xr pam 8
 267 .It Pa sys/
 268 system C include files (kernel data structures)
 269 .It Pa ufs/
 270 C include files for UFS (The U-word File System)
 271 .Pp
 272 .Bl -tag -width ".Pa ffs/" -compact
 273 .It Pa ffs/
 274 Fast filesystem
 275 .It Pa mfs/
 276 memory file system;
 277 see
 278 .Xr mount_mfs 8
 279 .It Pa ufs/
 280 UFS filesystem
 281 .El
 282 .Pp
 283 .It Pa vm/
 284 virtual memory;
 285 see
 286 .Xr vmstat 8
 287 .El
 288 .Pp
 289 .It Pa lib/
 290 archive libraries
 291 .Pp
 292 .Bl -tag -width ".Pa engines/" -compact
 293 .It Pa aout/
 294 a.out archive libraries
 295 .It Pa engines/
 296 OpenSSL dynamic engines
 297 .El
 298 .Pp
 299 .It Pa libdata/
 300 misc. utility data files
 301 .It Pa libexec/
 302 system daemons & system utilities (executed by other programs)
 303 .Pp
 304 .Bl -tag -width ".Pa binutils224/" -compact
 305 .It Pa binutils224/
 306 .Pp
 307 .Bl -tag -width ".Pa ldscripts/" -compact
 308 .It Pa ldscripts/
 309 linker scripts;
 310 see
 311 .Xr ld 1
 312 .El
 313 .Pp
 314 .It Pa binutils225/
 315 .Pp
 316 .Bl -tag -width ".Pa ldscripts/" -compact
 317 .It Pa ldscripts/
 318 linker scripts;
 319 see
 320 .Xr ld 1
 321 .El
 322 .Pp
 323 .It Pa lpr/
 324 utilities and filters for LP print system;
 325 see
 326 .Xr lpr 1
 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 sbin/
 369 system daemons & system utilities (executed by users)
 370 .It Pa share/
 371 architecture-independent files
 372 .Pp
 373 .Bl -tag -width ".Pa groff_font/" -compact
 374 .It Pa calendar/
 375 a variety of pre-fab calendar files;
 376 see
 377 .Xr calendar 1
 378 .It Pa dict/
 379 word lists;
 380 see
 381 .Xr look 1
 382 .Pp
 383 .Bl -tag -width ".Pa papers/" -compact
 384 .It Pa web2
 385 words from Webster's 2nd International
 386 .It Pa words
 387 common words
 388 .It Pa papers/
 389 reference databases;
 390 see
 391 .Xr refer 1
 392 .El
 393 .Pp
 394 .It Pa doc/
 395 miscellaneous documentation
 396 .Pp
 397 .Bl -tag -width ".Pa legal/" -compact
 398 .It Pa legal/
 399 License files for vendor supplied firmware
 400 .El
 401 .Pp
 402 .It Pa examples/
 403 various examples for users and programmers
 404 .It Pa games/
 405 ASCII text files used by various games
 406 .It Pa groff_font/
 407 device description file for device name
 408 .It Pa i18n/
 409 internationalization databases; see
 410 .Xr iconv 3
 411 .It Pa info/
 412 GNU Info hypertext system
 413 .It Pa libg++/
 414 libg++'s genclass prototype/template class files
 415 .It Pa locale/
 416 localization files;
 417 see
 418 .Xr setlocale 3
 419 .It Pa man/
 420 manual pages
 421 .It Pa me/
 422 macros for use with the me macro package;
 423 see
 424 .Xr me 7
 425 .It Pa misc/
 426 misc system-wide ASCII text files
 427 .Pp
 428 .Bl -tag -width ".Pa termcap" -compact
 429 .It Pa termcap
 430 terminal characteristics database;
 431 see
 432 .Xr termcap 5
 433 .El
 434 .Pp
 435 .It Pa mk/
 436 templates for make;
 437 see
 438 .Xr make 1
 439 .It Pa nls/
 440 national language support files;
 441 see
 442 .Xr nls 7
 443 .It Pa openssl/
 444 .Pp
 445 .Bl -tag -width ".Pa man/" -compact
 446 .It Pa man/
 447 OpenSSL manual pages
 448 .El
 449 .Pp
 450 .It Pa sendmail/
 451 sendmail configuration files;
 452 see
 453 .Xr sendmail 8
 454 .It Pa skel/
 455 example . (dot) files for new accounts
 456 .It Pa syscons/
 457 files used by
 458 .Xr syscons 4
 459 .Pp
 460 .Bl -tag -width ".Pa scrnmaps/" -compact
 461 .It Pa fonts/
 462 console fonts;
 463 see
 464 .Xr vidcontrol 1
 465 and
 466 .Xr vidfont 1
 467 .It Pa keymaps/
 468 console keyboard maps;
 469 see
 470 .Xr kbdcontrol 1
 471 and
 472 .Xr kbdmap 1
 473 .It Pa scrnmaps/
 474 console screen maps
 475 .El
 476 .Pp
 477 .It Pa tabset/
 478 tab description files for a variety of terminals; used in
 479 the termcap file;
 480 see
 481 .Xr termcap 5
 482 .It Pa terminfo/
 483 compiled
 484 .Xr terminfo 5
 485 database files
 486 .It Pa tmac/
 487 text processing macros;
 488 see
 489 .Xr nroff 1
 490 and
 491 .Xr troff 1
 492 .It Pa vi/
 493 localization support and utilities for
 494 .Xr vi 1
 495 .It Pa zoneinfo/
 496 timezone configuration information;
 497 see
 498 .Xr tzfile 5
 499 .El
 500 .Pp
 501 .It Pa src/
 502 .Bx ,
 503 third-party, and/or local source files
 504 .Pp
 505 .Bl -tag -width ".Pa nrelease/" -compact
 506 .It Pa bin/
 507 source code for files in
 508 .Pa /bin
 509 .It Pa contrib/
 510 source code for contributed software
 511 .It Pa crypto/
 512 source code for contributed cryptography software
 513 .It Pa etc/
 514 source code for files in
 515 .Pa /etc
 516 .It Pa games/
 517 source code for files in
 518 .Pa /usr/games
 519 .It Pa gnu/
 520 Utilities covered by the GNU General Public License
 521 .It Pa include/
 522 source code for files in
 523 .Pa /usr/include
 524 .It Pa lib/
 525 source code for files in
 526 .Pa /usr/lib
 527 .It Pa libexec/
 528 source code for files in
 529 .Pa /usr/libexec
 530 .It Pa nrelease/
 531 files required to produce a
 532 .Dx
 533 release
 534 .It Pa sbin/
 535 source code for files in
 536 .Pa /sbin
 537 .It Pa share/
 538 source for files in
 539 .Pa /usr/share
 540 .It Pa sys/
 541 kernel source code
 542 .It Pa tools/
 543 tools used for maintenance and testing of
 544 .Dx
 545 .It Pa usr.bin/
 546 source code for files in
 547 .Pa /usr/bin
 548 .It Pa usr.sbin/
 549 source code for files in
 550 .Pa /usr/sbin
 551 .El
 552 .El
 553 .It Pa /var/
 554 multi-purpose log, temporary, transient, and spool files
 555 .Pp
 556 .Bl -tag -width ".Pa preserve/" -compact
 557 .It Pa account/
 558 system accounting files
 559 .Pp
 560 .Bl -tag -width ".Pa acct" -compact
 561 .It Pa acct
 562 execution accounting file;
 563 see
 564 .Xr acct 5
 565 .El
 566 .Pp
 567 .It Pa at/
 568 timed command scheduling files;
 569 see
 570 .Xr \&at 1
 571 .Pp
 572 .Bl -tag -width ".Pa spool/" -compact
 573 .It Pa jobs/
 574 directory containing job files
 575 .It Pa spool/
 576 directory containing output spool files
 577 .El
 578 .Pp
 579 .It Pa backups/
 580 misc. backup files
 581 .It Pa crash/
 582 default directory to store kernel crash dumps; see
 583 .Xr crash 8
 584 and
 585 .Xr savecore 8
 586 .It Pa cron/
 587 files used by cron;
 588 see
 589 .Xr cron 8
 590 .Pp
 591 .Bl -tag -width ".Pa tabs/" -compact
 592 .It Pa tabs/
 593 crontab files;
 594 see
 595 .Xr crontab 5
 596 .El
 597 .Pp
 598 .It Pa db/
 599 misc. automatically generated system-specific database files
 600 .It Pa empty/
 601 empty directory used by
 602 .Xr sshd 8
 603 for privilege separation
 604 .It Pa games/
 605 misc. game status and score files
 606 .It Pa hammer/
 607 per PFS (pseudo file system) snapshots directory for
 608 .Xr hammer 5
 609 file systems
 610 .It Pa log/
 611 misc. system log files
 612 .Pp
 613 .Bl -tag -width ".Pa wtmp" -compact
 614 .It Pa wtmp
 615 login/logout log;
 616 see
 617 .Xr wtmp 5
 618 .El
 619 .Pp
 620 .It Pa mail/
 621 user mailbox files
 622 .It Pa msgs/
 623 system messages database;
 624 see
 625 .Xr msgs 1
 626 .It Pa preserve/
 627 temporary home of files preserved after an accidental death
 628 of an editor;
 629 see
 630 .Xr \&ex 1
 631 .It Pa quotas/
 632 filesystem quota information files
 633 .It Pa run/
 634 system information files describing various info about
 635 system since it was booted
 636 .Pp
 637 .Bl -tag -width ".Pa ppp/" -compact
 638 .It Pa ppp/
 639 writable by the
 640 .Dq network
 641 group for command connection sockets; see
 642 .Xr ppp 8
 643 .It Pa utmp
 644 database of current users;
 645 see
 646 .Xr utmp 5
 647 .It Pa sem/
 648 rendez-vous files for posix named semaphores;
 649 see
 650 .Xr sem_open 3
 651 .El
 652 .Pp
 653 .It Pa rwho/
 654 rwho data files;
 655 see
 656 .Xr rwhod 8 ,
 657 .Xr rwho 1 ,
 658 and
 659 .Xr ruptime 1
 660 .It Pa spool/
 661 misc. printer and mail system spooling directories
 662 .Pp
 663 .Bl -tag -width ".Pa clientmqueue/" -compact
 664 .It Pa clientmqueue/
 665 undelivered submission mail queue;
 666 see
 667 .Xr sendmail 8
 668 .It Pa dma/
 669 undelivered mail queue;
 670 see
 671 .Xr dma 8
 672 .It Pa ftp/
 673 commonly
 674 .Pa ~ftp ;
 675 the anonymous ftp root directory
 676 .It Pa mqueue/
 677 undelivered mail queue;
 678 see
 679 .Xr sendmail 8
 680 .It Pa output/
 681 line printer spooling directories
 682 .It Pa uucp/
 683 uucp spool directory
 684 .It Pa uucppublic/
 685 commonly
 686 .Pa ~uucp ;
 687 public uucp temporary directory
 688 .El
 689 .Pp
 690 .It Pa tmp/
 691 temporary files that are kept between system reboots
 692 .Pp
 693 .Bl -tag -width ".Pa vi.recover/" -compact
 694 .It Pa vi.recover/
 695 the directory where recovery files are stored
 696 .El
 697 .Pp
 698 .It Pa yp/
 699 the NIS maps
 700 .El
 701 .El
 702 .Sh NOTES
 703 This manual page documents the default
 704 .Dx
 705 filesystem layout, but
 706 the actual hierarchy on a given system is defined at the system
 707 administrator's discretion.
 708 A well-maintained installation will include a customized version of
 709 this document.
 710 .Sh SEE ALSO
 711 .Xr apropos 1 ,
 712 .Xr find 1 ,
 713 .Xr finger 1 ,
 714 .Xr grep 1 ,
 715 .Xr ls 1 ,
 716 .Xr whatis 1 ,
 717 .Xr whereis 1 ,
 718 .Xr which 1 ,
 719 .Xr fsck 8
 720 .Sh HISTORY
 721 A
 722 .Nm
 723 manual page appeared in
 724 .At v7 .