home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #4 / amigamamagazinepolishissue1998.iso / netbsd / release.man < prev    next >
Text File  |  1997-12-07  |  8KB  |  336 lines
  1. RELEASE(7)            NetBSD Reference Manual            RELEASE(7)
  2.  
  3. NAME
  4.      release - layout of NetBSD releases and snapshots
  5.  
  6. DESCRIPTION
  7.      This document describes the layout of NetBSD releases and snapshots.
  8.      This layout should be consistent between FTP servers and CD-ROMs, except
  9.      possibly the path that leads to the release hierarchy.
  10.  
  11.      In this document, the following special words have these definitions:
  12.  
  13.      <machine>         The platform for which the release was built, correspond-
  14.              ing to the hw.machine sysctl variable, e.g.  i386 or
  15.              amiga.
  16.  
  17.      <machine_arch>  The architecture for which a particular installation set
  18.              was built, corresponding to the hw.machine_arch sysctl
  19.              variable, e.g.  i386 or m68k.
  20.  
  21.      <rel>         The target release.
  22.  
  23.      All README files are descriptions of the various files in directories
  24.      that have ``non-standard'' contents.
  25.  
  26.      All BSDSUM files are historic BSD checksums for the various files in that
  27.      directory, in the format produced by the command: cksum -o 1 <file>.
  28.  
  29.      All CKSUM files are POSIX checksums for the various files in that direc-
  30.      tory, in the format produced by the command: cksum <file>.
  31.  
  32.      All MD5 files are MD5 digests for the various files in that directory, in
  33.      the format produced by the command: cksum -m <file>.
  34.  
  35.      All SYSVSUM files are historic AT&T System V UNIX checksums for the vari-
  36.      ous files in that directory, in the format produced by the command: cksum
  37.      -o 2 <file>.
  38.  
  39.      The MD5 digest is the safest checksum, followed by the POSIX checksum.
  40.      The other two checksums are provided only to ensure that the widest pos-
  41.      sible range of system can check the integrity of the release files.
  42.  
  43.      Files that end in .tgz are gzipped tar archives.  This is used in lieu of
  44.      .tar.gz because the software used to download the sets may incorrectly
  45.      auto-unpack files ending in .gz and to accomodate systems which only sup-
  46.      port 3 character extensions to file names.
  47.  
  48.      All tar archives are relative to the target's / directory, and do not in-
  49.      clude the leading ``/''.
  50.  
  51.      All compression of release files is to be performed with the command:
  52.      gzip -9.
  53.  
  54.      The root of the release hierarchy is .../NetBSD-<rel>/<machine>/. For
  55.      files which may be shared by all systems of the same <machine_arch>,
  56.      (e.g. the games and xbase sets for m68k-based platforms), this hierarchy
  57.      will have a second root of .../NetBSD-<rel>/<machine_arch>/ which will
  58.      contain those files.  For files which are completely machine-independent
  59.      (e.g. the xfont set), this hierarchy will have a third root of
  60.      .../NetBSD-<rel>/mi/ which will contain those files.  Unless otherwise
  61.      noted, all files may be symbolic links to common <machine_arch> or ma-
  62.      chine-independent files located in their respective directory hierar-
  63.      chies.
  64.  
  65.      SOURCE_DATE    a file containing the date, in UTC, of the source code
  66.             from which the release or snapshot was built, in the de-
  67.             fault format produced by the command: date -u
  68.  
  69.      INSTALL        Installation notes, including complete descriptions of
  70.             files contained within the release hierarchy
  71.  
  72.      binary/        system binaries
  73.  
  74.             sets/      installation sets
  75.  
  76.                    BSDSUM
  77.  
  78.                    CKSUM
  79.  
  80.                    MD5
  81.  
  82.                    SYSVSUM
  83.  
  84.                    Split/         installation sets split with the
  85.                          split(1) command.    Note: split
  86.                          installation sets may not be
  87.                          available for all platforms.
  88.  
  89.                          BSDSUM
  90.  
  91.                          CKSUM
  92.  
  93.                          MD5
  94.  
  95.                          SYSVSUM
  96.  
  97.                          base.aa
  98.  
  99.                          base.ab
  100.  
  101.                          ...
  102.  
  103.                    base.tgz         The base binary distribution.
  104.                          This set contains the base NetBSD
  105.                          utilities that are necessary for
  106.                          the system to run and be minimal-
  107.                          ly functional.  It includes
  108.                          shared libraries for those archi-
  109.                          tectures that support support
  110.                          them.  This set excludes all
  111.                          things listed in the sets de-
  112.                          scribed below.
  113.  
  114.                    comp.tgz         The compiler tools distribution.
  115.                          This set contains the C and C++
  116.                          compilers, assembler, linker,
  117.                          other toolchain components, and
  118.                          their manual pages.  It also in-
  119.                          cludes the system include files
  120.                          (/usr/include) , and the static
  121.                          system libraries.
  122.  
  123.                    etc.tgz         This set contains the system con-
  124.                          figuration files that reside in
  125.                          /etc and in several other places
  126.                          throughout the file system hier-
  127.                          archy.
  128.  
  129.                    games.tgz     This set includes the games and
  130.  
  131.  
  132.                          their manual pages.
  133.  
  134.                    kern.tgz         This set includes a generic ker-
  135.                          nel.
  136.  
  137.                    man.tgz         This set includes all of the man-
  138.                          ual pages for the binaries and
  139.                          other software contained in the
  140.                          base set which are not included
  141.                          in the other sets.
  142.  
  143.                    misc.tgz         This set includes the system dic-
  144.                          tionaries (which are rather
  145.                          large), the typesettable document
  146.                          set, and manual pages for other
  147.                          architectures, which happen to be
  148.                          installed from the source tree by
  149.                          default.
  150.  
  151.                    text.tgz         This set includes the NetBSD text
  152.                          processing tools, including
  153.                          groff(1),    all related programs,
  154.                          and their manual pages.
  155.  
  156.                    xbase.tgz     This set includes the base X11
  157.                          distribution, including manual
  158.                          pages and shared libraries for
  159.                          those architectures that support
  160.                          them, and excluding everything
  161.                          contained in the other X11 sets.
  162.  
  163.                    xcomp.tgz     This set includes the X11 include
  164.                          files and static X11 libraries.
  165.  
  166.                    xcontrib.tgz  This set includes binaries and
  167.                          manual pages for programs built
  168.                          from the X11 ``contrib'' sources.
  169.  
  170.                    xfont.tgz     This set includes the X11 fonts.
  171.  
  172.                    xserver.tgz   This set includes the X servers
  173.                          and manual pages for <machine>.
  174.                          Note: this set may not be
  175.                          available on some platforms.
  176.  
  177.             kernel/    suitably named, gzipped kernels
  178.  
  179.                    BSDSUM
  180.  
  181.                    CKSUM
  182.  
  183.                    MD5
  184.  
  185.                    README
  186.  
  187.                    SYSVSUM
  188.  
  189.                    netbsd-GENERIC.gz  A kernel built from the
  190.                           GENERIC kernel configuration
  191.                           file.     This is meant as an
  192.                           example only; different
  193.                           platforms may have differ-
  194.                           ently named kernels.
  195.  
  196.  
  197.  
  198.             security/  security-related system binaries
  199.  
  200.                    BSDSUM
  201.  
  202.                    CKSUM
  203.  
  204.                    MD5
  205.  
  206.                    SYSVSUM
  207.  
  208.                    Split/
  209.  
  210.                      BSDSUM
  211.  
  212.                      CKSUM
  213.  
  214.                      MD5
  215.  
  216.                      SYSVSUM
  217.  
  218.                      secr.aa
  219.  
  220.                      secr.ab
  221.  
  222.                      ...
  223.  
  224.                    secr.tgz     This set contains executables which
  225.                      are built from the ``src/domestic''
  226.                      portion of the NetBSD source tree.
  227.                      It can only be found on those sites
  228.                      which carry the complete NetBSD dis-
  229.                      tribution and can legally obtain it.
  230.                      (Remember, because of United States
  231.                      law, it may not be legal to dis-
  232.                      tribute this set to locations outside
  233.                      the United States and Canada.)
  234.  
  235.      installation/  installation helper items
  236.  
  237.             diskimage/    disk images, for those platforms that provide
  238.                 them
  239.  
  240.                 BSDSUM
  241.  
  242.                 CKSUM
  243.  
  244.                 MD5
  245.  
  246.                 README
  247.  
  248.                 SYSVSUM
  249.  
  250.                 diskimage-rz25.gz
  251.  
  252.             floppy/    floppy images, for those platforms that pro-
  253.                 vide them
  254.  
  255.                 BSDSUM
  256.  
  257.                 CKSUM
  258.  
  259.                 MD5
  260.  
  261.                 README
  262.  
  263.  
  264.                 SYSVSUM
  265.  
  266.                 floppy-144.gz
  267.  
  268.             miniroot/    miniroot images, for those platforms that pro-
  269.                 vide them
  270.  
  271.                 BSDSUM
  272.  
  273.                 CKSUM
  274.  
  275.                 MD5
  276.  
  277.                 README
  278.  
  279.                 SYSVSUM
  280.  
  281.                 miniroot.gz
  282.  
  283.             misc/    miscellaneous installation helper utilities,
  284.                 including boot selectors, floppy writing soft-
  285.                 ware, other software that runs under foreign
  286.                 operating systems, etc.
  287.  
  288.                 BSDSUM
  289.  
  290.                 CKSUM
  291.  
  292.                 MD5
  293.  
  294.                 README
  295.  
  296.                 SYSVSUM
  297.  
  298.                 ...
  299.  
  300.             netboot/    network boot programs
  301.  
  302.                 BSDSUM
  303.  
  304.                 CKSUM
  305.  
  306.                 MD5
  307.  
  308.                 README
  309.  
  310.                 SYSVSUM
  311.  
  312.                 netboot.gz
  313.  
  314.             tapeimage/    tape images, for those platforms that provide
  315.                 them
  316.  
  317.                 BSDSUM
  318.  
  319.                 CKSUM
  320.  
  321.                 MD5
  322.  
  323.                 README
  324.  
  325.                 SYSVSUM
  326.  
  327.                 tapeimage-hp9144.gz
  328.  
  329. SEE ALSO
  330.      cksum(1),    date(1),  gzip(1),  split(1),  tar(1)
  331.  
  332. HISTORY
  333.      The release manual page first appeared in NetBSD 1.3.
  334.  
  335. NetBSD                   November 18, 1997                 6
  336.