Home | History | Annotate | Line # | Download | only in sets 
      1 # $NetBSD: README,v 1.16 2021/09/25 08:54:30 maya Exp $
      2 
      3 the scripts should be run from the directory where they reside.
      4 
      5 makeflist:	output the list of files that should be in a
      6 		distribution, according to the contents of the
      7 		'lists' directory.
      8 
      9 checkflist:	check the file list (as internally generated
     10 		by makeflist) against the tree living in $DESTDIR.
     11 		(that tree should be made with 'make distribution'.)
     12 
     13 maketars:	make tarballs of the various sets in the distribution,
     14 		based on the contents of the lists, the tree in
     15 		$DESTDIR, and put the tarballs in $RELEASEDIR.
     16 		Note that this script _doesn't_ create the 'secr'
     17 		distribution, because (for now) it requires
     18 		manual intervention to get the binaries right...
     19 		(i'll add another script to create that dist, later.)
     20 
     21 what's in 'lists':
     22 
     23 lists describing file sets.  There are two sets of lists per file
     24 set: machine dependent and machine-independent files. (there's
     25 also another file in the 'man' dir, which is used by the 'man'
     26 and 'misc' sets, but that's explained later.)
     27 
     28 There is one machine-independent file, named "mi".  There are
     29 N machine-dependent files (one per architecture), named "md.${ARCH}".
     30 
     31 the sets are as follows:
     32 
     33 	base:	the base binary set.  excludes everything described
     34 		below.
     35 
     36 	comp:	compiler tools.  All of the tools relating to C, C++,
     37 		and FORTRAN (yes, there are two!) that are in the
     38 		tree.  This includes includes, the linker, tool chain,
     39 		and the .a versions of the libraries.  (obviously,
     40 		base includes ldd, ld.so, and the shared versions.
     41 		base also includes 'cpp', because that's used by X11.)
     42 		includes the man pages for all the binaries contained
     43 		within.  Also, includes all library and system call
     44 		manual pages.
     45 
     46 	debug:	Debugging libraries (_g.a/MKDEBUGLIB) and (.debug/MKDEBUG)
     47 		binaries.
     48 
     49 	dtb:	Device tree blobs (MKDTB).
     50 
     51 	etc:	/etc, and associated files (/var/cron/tabs, /root,
     52 		etc.).  things that shouldn't be blindly reinstalled
     53 		on an upgrade.
     54 
     55 	games:	the games and their man pages.
     56 
     57 	gpufw:	heavy firmware files used by graphical drivers.
     58 
     59 	man:	all of the man pages for the system, except those
     60 		listed elsewhere (e.g. in comp, games, misc, text).
     61 		Includes machine-dependent man pages for this CPU.
     62 
     63 	misc:	share/dict, share/doc, and the machine-dependent
     64 		man pages for other CPUs which happen to always
     65 		be installed.
     66 
     67 	modules:	stand/${MACHINE}/${OSRELEASE}/modules kernel modules
     68 
     69 	rescue:	Standalone system recovery tools.
     70 
     71 	tests:	unit, regression, integration and stress tests for the
     72 		whole system.
     73 
     74 	text:	text processing tools.  groff and all of its friends.
     75 		includes man pages for all bins contained within.
     76 
     77 Each set must contain "./etc/mtree/set.<set name>" within the mi
     78 list.  Failure to add this will break unprivileged builds.
     79