-
- admin - package admin wrapper
-
- admin [ options ] [ host ... | - package ... | - file ... ]
-
- admin provides a single interface for package administration. Operations include making, testing, localizing, packaging, posting to the web, and
updating /usr/common/ast. If no action options are specified then admin.db is listed. admin only runs in the $PACKAGEROOT/lib/package/admin
directory.
-
- admin is controlled by several input files that provide default values for repeated operations.
- VERSION
- A sh(1) file that specifies default values for the following shell
variables:
- ANNOUNCE
- The --announce mail group address.
- BETA
- The packages named by --beta.
- COMMON
- The PACKAGEROOT directory for local official binaries. The default is /usr/common/ast.
- DIALECTS
- The default dialects updated by --catalog. The default is chef,fudd,piglatin,valley.
- EXTERNAL
- These packages will be posted to the internal and external download web sites.
- HOST
- The internal url host name. The default is www.research.att.com.
- HOST_PUBLIC
- The public url host name. The default is public.research.att.com.
- HOST_STAGE
- The stage url host name. The default is www-stage.research.att.com.
- IMPORT
- These packages have tarballs that are imported from other systems and are not to be generated on the local system.
- INTERNAL
- These packages be posted to the internal download web site only.
- SAVE
- The packages named by --save.
- SOURCE
- These packages are source only.
- TITLE
- The software title for the --announce message.
- USER
- The url cgi user name. The default is the user name of the caller.
- VERSION
- The YYYY-MM-DD for the current base.
- VERSION_BETA
- The YYYY-MM-DD for the beta base.
- WWWLOCAL
- Local directory for internal server files. If not defined then files may only be accessed from $HOST.
- admin.db
- A table of local hosts and architectures used by the admin action of the package(1)
command.
- post.db
- A sh(1) file of post(1)
functions that describes the files and packages to be posted to the download web site.
-
- -a, --all
- Equivalent to --make --locale --binary --source --force --post.
- -A, --log
- Append terminal output to admin.log. On by default; -A means --nolog.
- -B, --base
- Generate new base archives. By default delta archives on the previous base are generated.
- -Q, --beta
- Operate on the BETA packages.
- -b, --binary
- Generate binary package archives in ../tgz.
- -c, --catalog
- Generate and update local message catalogs and html man pages.
- -q, --check
- Check generated --binary tarballs.
- -C, --common
- List the steps required to update /usr/common/ast
- -d, --ditto
- Run package admin ditto.
- -f, --failed
- List only failed --results.
- -F, --force
- Force --catalog and --post actions to ignore timestamps.
- -g, --generate
- List the package generation results.
- -h, --html
- Update html --post files and copy to the internal site.
- -H, --hosts
- List the hosts in admin.db.
- -J, --architectures
- List the architectures in admin.db.
- -k, --kick
- Kick NFS to freshen up stale file handles -- puke.
- -K, --clean
- Clean out binary packages in ../tgz by removing all but the most recent release.
- -l, --list
- List admin.db. This is the default if no actions are specified.
- -Y, --local
- Generate local --post files but to not post(1).
- -L, --locale
- Operate on the *-locale packages for the specified packages.
- -m, --make
- Run package admin make.
- -M, --announce
- Mail a www posting announcement to ast-users
- -n, --exec
- --noexec passes show or -n to wrapped commands. On by default; -n means --noexec.
- -N, --show
- Show admin actions but do not execute.
- -o, --only
- Operate only on the specified packages. By default a package closure is generated.
- -O, --official
- Operate on the INTERNAL and EXTERNAL packages.
- -e, --patch
- Generate a delta2patch(1) patch on the standard output of the latest
delta tarball from its base for each package operand.
- -p, --post
- Post binary packages and download web pages using post(1).
- -P, --public
- Copy external web pages from the internal site to the public site.
- -y, --regress
- Compare --test results with previous. Results are stored in the regress.log directory.
- -E, --release=release
- Do not post packages older than release.
- -R, --remote
- List common actions to take on remote hosts.
- -r, --results
- List --make results for the host name operands or all hosts if there are no operands. If --test is also specified
then an rt(1) summary of test results is listed.
- -U, --runtime
- Generate runtime binary base package archives in ../tgz. --base and --only are also set.
- -s, --source
- Generate source package archives in ../tgz.
- -S, --save
- Generate the SAVE source package archives in ../lcl.
- -G, --stage
- Copy external web pages from the internal site to the stage site.
- -t, --test
- Run package admin test.
- -T, --targets=targets
- Optional --make targets.
- -u, --update
- Update local --post files but do not copy to the internal site.
- -v, --version=YYYY-MM-DD
- Set the current --base package release version.
- -x, --etxtbsy
- Remove all ETXTBSY files. These files are copied during installation to avoid clobbering running programs/dlls on stateless
filesystems.
- -X, --remotes
- List remote host type access for each host. access is r for rsh and s for ssh. If --only
is specified then only one host per type is listed.
- -z, --leadlag
- Extract filesystem timestamp lead/lag messages from the file operands. If no file operands are specified then make.log/*
is assumed.
- -Z, --tst
- Write tst packages (no source copyright prepended).
-
- The typical development cycle is:
- # generate base source packages for beta testing in ../tgz
- admin --base --source --beta
- # or delta source packages for beta testing in ../tgz
- admin --source --beta
- # make the local executables
- admin --make
- # check the make results
- admin --results --failed | less -p "^(==>).*"
- # run the regression tests
- admin --test
- # check the test results
- admin --regress
- # or
- admin --results --failed --test | less -p "^(==>|TEST).*"
-
- The typical packaging steps are:
- # generate the locale message catalogs
- admin --catalog
- # generate base locale, source and binary packages in
../lcl, ../tgz
- admin --base --save --locale --source --binary --official
- # or delta locale, source and binary packages in ../lcl, ../tgz
- admin --save --locale --source --binary --official
- # manually generate ksh --static-link standalone for cygwin.i386
- # check the package generation results
- admin --results --failed --generate | less
- # remove old binaries
- admin --clean
- # check the generated binaries
- admin --check
- # update the internal web site
- admin --post
- # update /usr/common/ast by following the instructions from
- admin --common
-
- To update the stage and external web sites:
- # surf http://www.research.att.com/sw/download/
- # check for internal seepage into ~/www/download/@
(make|test).*.html
- # update the stage site
- admin --stage
- # surf http://www-stage.research.att.com/sw/download/
- # update the public site
- admin --public
- # surf http://public.research.att.com/sw/download/
- # mail ast-users # to announce the posting
- admin --announce
-
-
- external(1), mkwwwman(1), package(1),
post(1), common-install(1)
-
- version
- admin (AT&T Research) 2008-01-01
- author
- Glenn Fowler <gsf@research.att.com>
- copyright
- Copyright © 2000-2008 AT&T Intellectual Property
- license
- http://www.opensource.org/licenses/cpl1.0.txt