= create, inst, info: archive or update a file system == SYNOPSIS *install/create* [*-u*] [*-U*] [*-v*] [*-x*] [*-o*] [*-p* _proto_] [*-r*_root_] [*-s* _source_] [*-N* _uid_] [*-G* _gid_] [*-d* _description_]_name_ *install/inst* [*-c*] [*-h*] [*-t*] [*-u*] [*-v*] [*-F*] [*-r* _root_]_name_ [_prefix_ _..._] *install/info* [*-r*] _package_  _Create_ copies files from the file tree _source_ (default */*) to anoutput file in archive format appropriate for a software distribution.The name of the output file is the time that the archive was made. Thelatter includes wrap headers that describe the distribution. _Name_ istypically the name of the product or software package. The *-p* optionspecifies the prototype file _proto_ to use to build the archive. Each line of the _proto_ file specifies a file to copy. Indentation issignificant, with each level of indentation corresponding to a level inthe file tree. Fields within a line are separated by white space. Thefirst field is the last path element in the destination file tree. Thesecond field specifies the permissions. The third field is the owner ofthe file, and the fourth is the group owning the file. The fifth fieldis the name of the file from which to copy; this file is read from thecurrent name space, not the source file tree. All fields except thefirst are optional. Names beginning with a are expanded as environment variables. If the first file specified in adirectory is all of the files in that directory are copied. If the first file is all of the non-directory files in that directory are copied. If thefirst file is all of the files are copied, and all subdirectories are recursivelycopied. Files in the source tree that are not specified in the _proto_ file arenot placed in the archive. The remaining options to _create_ are: *-u*::  Build an update distribution rather than a base distribution. In this  case _name_ should be the name of the previous archive file built for  this product. Only files that are out of date with respect to the  latter are included in the archive. Files which no longer exist will  be marked for removal.*-U*::  Build an update package distribution instead. This is a hybrid of a  base distribution and an update distribution.*-v*::  Print out the files as they go into the archive.*-x*::  Print out the files that would go into the archive but do not actually  archive them.*-o*::  Copy the archive file to the standard output rather than putting it in  a date stamped output file.*-r root*::  Specifies the location of any previous archives for this product.*-N uid*::  Give all the files in the archive the user id specified.*-G gid*::  Give all the files in the archive the group id specified,*-d description*::  Give a description of the distribution. This is placed in the wrap  header files. _Inst_ installs archive files made by _create ._ _Name_ is the name ofthe archive file to install. Any further names after this are treated aspath prefixes and only files in the archive that have one of the givenprefixes are actually installed. The option to _inst_ are : *-c*::  Carry on regardless when errors occur. The default behaviour is to  exit on encountering an error.*-h*::  Only print the names of the files in the archive.*-t*::  Give each installed file the same date stamp as indicated by that  file's entry in the archive.*-u*::  Give each installed file the same date stamp, user id and group id as  shown in the archive.*-v*::  Print out the names of directories as they are installed.*-F*::  Force the installation of the files in the archive even when the  corresponding local file has apparently been locally updated or  already exists.*-r root*::  Specifies the root of destination tree where the files will be copied  to. _Info_ prints information about either a specific file produced by_create_ or about all files making up a package in the */wrap* tree. Inparticular base packages, full updates and partial updates aredistinguished. The *-r* option specifies the the root of the tree tolook in. This defaults to */*. == EXAMPLES Make an archive to establish a new base package for an Infernodistribution: ....install/create -o -N inferno -G inf -d InfernoOS -p PROTO Inferno.1.0 > inferno.arch.... Here the name of the product is Inferno.1.0. Install that archive on another machine: ....install/inst -r / inferno.arch.... Here the product is placed in / with the user and group ids being set tothose of the person doing the installation. == SOURCE */appl/cmd/install/arch.b* +*/appl/cmd/install/create.b* +*/appl/cmd/install/info.b* +*/appl/cmd/install/inst.b* +*/appl/cmd/install/proto.b* +*/appl/cmd/install/wrap.b* == SEE ALSO _archfs_(4)