RELEASE(7) NetBSD Reference Manual RELEASE(7) NNAAMMEE rreelleeaassee - layout of NetBSD releases and snapshots DDEESSCCRRIIPPTTIIOONN This document describes the layout of NetBSD releases and snapshots. This layout should be consistent between FTP servers and CD-ROMs, except possibly the path that leads to the release hierarchy. In this document, the following special words have these definitions: _<_m_a_c_h_i_n_e_> The platform for which the release was built, correspond- ing to the _h_w_._m_a_c_h_i_n_e sysctl variable, e.g. _i_3_8_6 or _a_m_i_g_a. _<_m_a_c_h_i_n_e___a_r_c_h_> The architecture for which a particular installation set was built, corresponding to the _h_w_._m_a_c_h_i_n_e___a_r_c_h sysctl variable, e.g. _i_3_8_6 or _m_6_8_k. _<_r_e_l_> The target release. All RREEAADDMMEE files are descriptions of the various files in directories that have ``non-standard'' contents. All BBSSDDSSUUMM files are historic BSD checksums for the various files in that directory, in the format produced by the command: cckkssuumm --oo 11 <>. All CCKKSSUUMM files are POSIX checksums for the various files in that direc- tory, in the format produced by the command: cckkssuumm <>. All MMDD55 files are MD5 digests for the various files in that directory, in the format produced by the command: cckkssuumm --mm <>. All SSYYSSVVSSUUMM files are historic AT&T System V UNIX checksums for the vari- ous files in that directory, in the format produced by the command: cckkssuumm --oo 22 <>. The MD5 digest is the safest checksum, followed by the POSIX checksum. The other two checksums are provided only to ensure that the widest pos- sible range of system can check the integrity of the release files. Files that end in ..ttggzz are gzipped tar archives. This is used in lieu of ..ttaarr..ggzz because the software used to download the sets may incorrectly auto-unpack files ending in ..ggzz and to accommodate systems which only support 3 character extensions to file names. All tar archives are relative to the target's // directory, and _d_o _n_o_t in- clude the leading ``/''. All compression of release files is to be performed with the command: ggzziipp --99. The root of the release hierarchy is ......//NNeettBBSSDD--_<_r_e_l_>//_<_m_a_c_h_i_n_e_>//. For files which may be shared by all systems of the same _<_m_a_c_h_i_n_e___a_r_c_h_>, (e.g. the ggaammeess and xxbbaassee sets for m68k-based platforms), this hierarchy will have a second root of ......//NNeettBBSSDD--_<_r_e_l_>//_<_m_a_c_h_i_n_e___a_r_c_h_>// which will contain those files. For files which are completely machine-independent (e.g. the xxffoonntt set), this hierarchy will have a third root of ......//NNeettBBSSDD--_<_r_e_l_>//mmii// which will contain those files. Unless otherwise noted, all files may be symbolic links to common _<_m_a_c_h_i_n_e___a_r_c_h_> or ma- chine-independent files located in their respective directory hierar- chies. SSOOUURRCCEE__DDAATTEE a file containing the date, in UTC, of the source code from which the release or snapshot was built, in the de- fault format produced by the command: ddaattee --uu IINNSSTTAALLLL..ttxxtt Installation notes, including complete descriptions of files contained within the release hierarchy IINNSSTTAALLLL..mmoorree pretty version of this, suited for viewing with more(1) IINNSSTTAALLLL..hhttmmll HTML version of this IINNSSTTAALLLL..ppss PostScript version of this bbiinnaarryy// system binaries sseettss// installation sets BBSSDDSSUUMM CCKKSSUUMM MMDD55 SSYYSSVVSSUUMM SSpplliitt// installation sets split with the split(1) command. _N_o_t_e_: _s_p_l_i_t _i_n_s_t_a_l_l_a_t_i_o_n _s_e_t_s _m_a_y _n_o_t _b_e _a_v_a_i_l_a_b_l_e _f_o_r _a_l_l _p_l_a_t_f_o_r_m_s. BBSSDDSSUUMM CCKKSSUUMM MMDD55 SSYYSSVVSSUUMM bbaassee..aaaa bbaassee..aabb ...... bbaassee..ttggzz The base binary distribution. This set contains the base NetBSD utilities that are necessary for the system to run and be minimal- ly functional. It includes shared libraries for those archi- tectures that support support them. This set excludes all things listed in the sets de- scribed below. ccoommpp..ttggzz The compiler tools distribution. This set contains the C and C++ compilers, assembler, linker, other toolchain components, and their manual pages. It also in- cludes the system include files (_/_u_s_r_/_i_n_c_l_u_d_e) , and the static system libraries. eettcc..ttggzz This set contains the system con- figuration files that reside in _/_e_t_c and in several other places throughout the file system hier- archy. ggaammeess..ttggzz This set includes the games and their manual pages. kkeerrnn..ttggzz This set includes a generic ker- nel. mmaann..ttggzz This set includes all of the man- ual pages for the binaries and other software contained in the bbaassee set which are not included in the other sets. mmiisscc..ttggzz This set includes the system dic- tionaries (which are rather large), the typesettable document set, and manual pages for other architectures, which happen to be installed from the source tree by default. tteexxtt..ttggzz This set includes the NetBSD text processing tools, including groff(1), all related programs, and their manual pages. xxbbaassee..ttggzz This set includes the base X11 distribution, including manual pages and shared libraries for those architectures that support them, and excluding everything contained in the other X11 sets. xxccoommpp..ttggzz This set includes the X11 include files and static X11 libraries. xxccoonnttrriibb..ttggzz This set includes binaries and manual pages for programs built from the X11 ``contrib'' sources. xxffoonntt..ttggzz This set includes the X11 fonts. xxsseerrvveerr..ttggzz This set includes the X servers and manual pages for . _N_o_t_e_: _t_h_i_s _s_e_t _m_a_y _n_o_t _b_e _a_v_a_i_l_a_b_l_e _o_n _s_o_m_e _p_l_a_t_f_o_r_m_s. kkeerrnneell// suitably named, gzipped kernels BBSSDDSSUUMM CCKKSSUUMM MMDD55 RREEAADDMMEE SSYYSSVVSSUUMM nneettbbssdd--GGEENNEERRIICC..ggzz A kernel built from the GGEENNEERRIICC kernel configuration file. This is meant as an example only; different platforms may have differ- ently named kernels. sseeccuurriittyy// security-related system binaries BBSSDDSSUUMM CCKKSSUUMM MMDD55 SSYYSSVVSSUUMM SSpplliitt// BBSSDDSSUUMM CCKKSSUUMM MMDD55 SSYYSSVVSSUUMM sseeccrr..aaaa sseeccrr..aabb ...... sseeccrr..ttggzz This set contains executables which are built from the ``_s_r_c_/_d_o_m_e_s_t_i_c'' portion of the NetBSD source tree. It can only be found on those sites which carry the complete NetBSD dis- tribution and can legally obtain it. (Remember, because of United States law, it may not be legal to dis- tribute this set to locations outside the United States and Canada.) iinnssttaallllaattiioonn// installation helper items ddiisskkiimmaaggee// disk images, for those platforms that provide them BBSSDDSSUUMM CCKKSSUUMM MMDD55 RREEAADDMMEE SSYYSSVVSSUUMM ddiisskkiimmaaggee--rrzz2255..ggzz ffllooppppyy// floppy images, for those platforms that pro- vide them BBSSDDSSUUMM CCKKSSUUMM MMDD55 RREEAADDMMEE SSYYSSVVSSUUMM ffllooppppyy--114444..ggzz mmiinniirroooott// miniroot images, for those platforms that pro- vide them BBSSDDSSUUMM CCKKSSUUMM MMDD55 RREEAADDMMEE SSYYSSVVSSUUMM mmiinniirroooott..ggzz mmiisscc// miscellaneous installation helper utilities, including boot selectors, floppy writing soft- ware, other software that runs under foreign operating systems, etc. BBSSDDSSUUMM CCKKSSUUMM MMDD55 RREEAADDMMEE SSYYSSVVSSUUMM ...... nneettbboooott// network boot programs BBSSDDSSUUMM CCKKSSUUMM MMDD55 RREEAADDMMEE SSYYSSVVSSUUMM nneettbboooott..ggzz ttaappeeiimmaaggee// tape images, for those platforms that provide them BBSSDDSSUUMM CCKKSSUUMM MMDD55 RREEAADDMMEE SSYYSSVVSSUUMM ttaappeeiimmaaggee--hhpp99114444..ggzz SSEEEE AALLSSOO cksum(1), date(1), gzip(1), split(1), tar(1) HHIISSTTOORRYY The rreelleeaassee manual page first appeared in NetBSD 1.3. NetBSD 1.4 November 18, 1997 6