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