Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

Subsections

• Synopsis
• Description
• Options
• Resources
• Notes
• Diagnostics
• Examples
• See also
• Author

sneeze

AIPS++ system rebuild utility.

Synopsis

sneeze [-e extlist] [-l] [-m mode] [-s seconds] targets

Description

sneeze is a part of the AIPS++ code distribution system. It is invoked by inhale (p)) to rebuild the AIPS++ system areas including object libraries, executables, and documentation. It can rebuild serially the systems for several aips_exts (see aipsinit (p)).

Before rebuilding the system, sneeze invokes ax_master with the -system option to delete unwanted files and directories from the system areas. On cumulative updates it invokes ax_master in cumulative mode and this deletes all static object libraries and class template repositories in addition to applying all deletions recorded in ax_master's action list. sneeze also invokes 'gmake -C $AIPSCODE cleansys' (§1.2) on cumulative updates to further clean up the system areas.

At the end of a cumulative update sneeze invokes 'gmake -f $AIPSARCH/makedefs diagnostics' to report the installed versions of third-party utilities essential for AIPS++ such as gmake (p), and also to print the current values of all makedefs (p) variables.

For a base installation (-m base), after the rebuild is complete and if not contra-indicated by the sneeze.base.$ARCH.preserve resource, sneeze preserves a copy of the system in $AIPSROOT/base-MM/..., where MM is the major version number of the new base release, and then invokes 'gmake -C $AIPSROOT/base-$NEWMAJOR/code/install aipsroot' to remake the root level directory.

sneeze maintains the LOGFILE file in $AIPSARCH which records the version, time of completion, and gmake (p) targets of the last rebuild (see avers (p)).

Options

-e extlist

Serially rebuild the systems corresponding to each aips_ext in the blank-, or colon-separated list. If no -e option is given sneeze just rebuilds the host's default architecture as specified in aipshosts (p). An ``_'' in the extlist signals no extension.

If there are any more aips_exts to be built after sneeze has finished the current one then it reinvokes itself with the -e option specifying an extlist from which the current aips_ext has been removed.

-l

Log mode - if specified then the output of sneeze will be logged to a file specified by the sneeze.$HOST.$AIPSEXT.logfile resource and mailed to the addresses specified by the sneeze.$HOST.$AIPSEXT.logmail resource. If these are not defined the log is sent to $AIPSARCH/sneeze.log and the mail to aips2-inhale@nrao.edu.

-m mode

Mode of the rebuild, incremental (default), cumulative, or base.

-s seconds

Interval in seconds to sleep before commencing build. This option is used to prevent concurrent builds from configuring glish at the same time.

If no targets are specified (makefiles (p)) sneeze remakes allsys.

Resources

sneeze always ignores $HOME/.aipsrc (see getrc (p)).

General resources.

• account.manager: Account name (and group) of the owner of the AIPS++ source code. sneeze only allows itself to be run from this account.

• account.programmer: (Account name and) name of the AIPS++ programmer group.

The following resources used by sneeze should be defined in $AIPSROOT/.aipsrc.

• sneeze.$HOST.$AIPSEXT.logfile: File in which the log produced by sneeze is preserved.

• sneeze.$HOST.$AIPSEXT.logmail: Addresses to which the log produced by sneeze is mailed.

• sneeze.$HOST.$AIPSEXT.mailer: Mail delivery program to use for log mailings. Defaults to mail.

• sneeze.base.$ARCH.preserve: If not false (see §6.2) then preserve the system for $AIPSARCH in $AIPSROOT/base-MM/... when a new base release is installed, where MM is the major version number of the new base release.

See also the inhale.sneeze.hosts resource used by inhale (p) to control how sneeze is invoked.

Notes

• sneeze is mainly intended for the use of inhale (p) rather than for general usage.

• It is assumed that the code areas have already been brought up-to-date with respect to the slave repositories (by inhale (p)).

• sneeze checks the directory ownerships and permissions on all AIPS++ system areas, reports incorrect ownerships, and silently fixes the group ownerships and permissions where possible.

• Since sneeze rebuilds the AIPS++ system which includes the sneeze executable it must take precautions to avoid overwriting itself. It does so by copying itself to sneeze- which it then execs. This also provides an opportunity for it to redirect its own output.

Diagnostics

Status return values
0: success
1: initialization error

Examples

sneeze is used by inhale (p) and should not normally be invoked manually. inhale (p) invokes it asynchronously on remote hosts with the -l option using .rshexec (p)), then executes it synchronously on the local host without the -l option.

See also

The unix manual page for mail(1).
AIPS++ variable names (§1.2).
affirm (p), get the Boolean value of a set of arguments.
aipshosts (p), AIPS++ hosts database.
avers (p), AIPS++ version report utility.
ax (p), AIPS++ code deletion utility.
getrc (p), query AIPS++ resource database.
inhale (p), AIPS++ code import utility.
makefiles (p), GNU makefiles used to rebuild AIPS++.

Author

Original: 1993/09/13 by Mark Calabretta, ATNF.