[0m


PACKAGEADMIN(8)     UNIX Programmer's Manual	  PACKAGEADMIN(8)



[1mNAME
     [0mpackageadmin - install or remove software packages

[1mSYNOPSIS
     /usr/sbin/packageadmin

DESCRIPTION
     [0m_P_a_c_k_a_g_e_a_d_m_i_n carries out the installation and removal of
     software [1mpackages[0m.  A [1mpackage [0mis a collection of related
     programs and data files (for example the X Window system,
     its tools and associated libraries).

     A [1mpackage [0mis saved as a _t_a_r(1) archive, held on floppy discs
     in _d_s_p_l_i_t(1) format - but _p_a_c_k_a_g_e_a_d_m_i_n takes care of all the
     details of installation/removal.

     _P_a_c_k_a_g_e_a_d_m_i_n is a menu driven program. The operations avail-
     able are:

	  - List packages installed.

	  - Install a package.

	  - Remove a package (optionally saving it to floppy
	    disc).

     Prompts generated by _p_a_c_k_a_g_e_a_d_m_i_n look like this:
	  [1minformative string (a/b/c) [c]>>
     [0mThis means that you can select one of three options (a, b or
     c); if you type [1m<return> [0mc will be used as the default.

     Most keyboard input is acted upon immediatly, but prompts
     with the options [1m(Y/N) [0m(generated by _d_s_p_l_i_t(1)) require the
     user to press [1m<return> [0mafter responding.

[1mIMPLEMENTATION DETAILS
     [0mPrograms and data used by _p_a_c_k_a_g_e_a_d_m_i_n are held in the
     directory /_p_a_c_k_a_g_e_s.

     Information about installed packages is held in the direc-
     tory /_p_a_c_k_a_g_e_s/_c_o_n_t_e_n_t_s.  Each subdirectory of _c_o_n_t_e_n_t_s
     describes one package, whose name is the same as the name of
     the directory.
     The contents of this directory (with optional components in
     brackets) are:

     files.Z
	    the files making up the package (ascii text, white
	    space separated; compressed using _c_o_m_p_r_e_s_s(1))

     version
	    a file containing information about the package,



Printed 6/4/92	    Revision 1.3 of 29/07/90			1






PACKAGEADMIN(8)     UNIX Programmer's Manual	  PACKAGEADMIN(8)



	    conventionally:

	    _p_a_c_k_a_g_e__n_a_m_e [1mVersion [0m_v_e_r_s_i_o_n__s_t_r_i_n_g

	    Displayed to the the user to give more information
	    about the package contents.

     [sizes]
	    a file describing the disc space occupancy of the
	    package
	    In the present implementation this contains two
	    lines:

	    USRNEEDED=<size in kbytes needed in usr partition>
	    ROOTNEEDED=<size in kbytes needed in root partition>

	    If not present, no size checks will be performed
	    (package will appear to have zero size).

     [install]
	    a shell script for carring out additional installa-
	    tion operations.  Executed after the package files
	    have been placed on the disc.

     [remove]
	    a shell script for carring out additional remove
	    operations.  Executed after package files have been
	    removed from the disc.

     Archived packages are kept as [1mdsplit[0m(1) [1mtar(1) [0marchives, the
     contents are:
	  /packages/contents/package_name/*
	  {all the files from
	  /packages/contents/package_name/files}
     The title of the [1mdsplit[0m(1) disc sequence is constructed from
     the name and the disc space requirements of the  package. It
     will look like:
	  [1mPackage: yp ROOTNEEDED=74 USRNEEDED=649

     [0mThere is a program /_p_a_c_k_a_g_e_s/_p_a_c_k_a_g_e_s_i_z_e which will add up
     the needs (in terms of kbytes) for the [1mroot [0mand [1musr [0mareas,
     for a set of files.
	  [1mpackagesize [0m<_f_i_l_e _l_i_s_t>
	  [1mpackagesize -f [0m<_f_i_l_e _c_o_n_t_a_i_n_i_n_g _f_i_l_e _l_i_s_t>
	  [1mpackagesize -f - [0m{_r_e_a_d _t_h_e _f_i_l_e_l_i_s_t _f_r_o_m _s_t_d_i_n}
     Output, on stdout, is suitable contents for the "sizes"
     file.  Any file whose pathname begins in [1m/usr [0mor [1musr [0mis
     included in the usr size. All others are contained in the
     root size.

[1mSEE ALSO
     [0m_d_s_p_l_i_t(1), _t_a_r(1)



Printed 6/4/92	    Revision 1.3 of 29/07/90			2






PACKAGEADMIN(8)     UNIX Programmer's Manual	  PACKAGEADMIN(8)























































Printed 6/4/92	    Revision 1.3 of 29/07/90			3






[0m