Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

Subsections

• Synopsis
• Description
• Options
• Diagnostics
• Examples
• Bugs
• See also
• Author

au

AIPS++ source code update utility.

Synopsis

au file1 [file2 ...]

Description

au updates the AIPS++ slave and code areas with the lastest version of a file in $AIPSMSTR.

au assumes that you are working within a private directory tree which shadows that of the AIPS++ master source code tree, see mktree (p). The filename arguments specified to au must be simple filenames without path or RCS ,v suffix. au determines the corresponding master directory from the current working directory.

au expects the master RCS repository, $AIPSMSTR, to be NFS mounted from the AIPS++ master host (see §1.1.4). It copies the RCS version file from the master to the slave RCS repository, giving it a file ownership defined by the owner of au (aips2mgr at the local site). au must itself have the setuid bit set (see chmod).

If successful, au then checks out a plain-text copy of the code from the $AIPSRCS subdirectory into the corresponding $AIPSCODE subdirectory.

Newly created directories on the master may also be propagated to the local installation.

Programmers who have an account on the AIPS++ master host, aips2.nrao.edu, may instead use a related utility, rau (p), which uses ssh to transfer the RCS version files in compressed form.

Programmers on a Linux or Digital UNIX platform, or on any other platform that does not support setuid shell scripts, should instead use a related utility, sau (p). sau runs a non-setuid copy of au, sau.sh, via a C-based setuid wrapper program.

Options

None.

Diagnostics

Status return values
0: success
1: initialization error
2: master file not found
3: slave not updated
4: code not updated

Examples

The command

   cd $HOME/aips++/code/install
   au au

would update the slave and plain-text copies of au, but not the script in the AIPS++ bin area.

Bugs

• au copies RCS version files directly from the master RCS repository, which may be NFS mounted from a machine on the other side of a slow internet link. The copy is handled more efficiently by rau (p) which compresses the files for transfer.

• au requires that the host operating system support setuid shell scripts. Some operating systems, most notably Linux and Digital UNIX, do not support setuid shell scripts for security reasons.

See also

The unix manual page for chmod(1).
AIPS++ variable names (§1.2).
ai (p), AIPS++ code checkin utility.
amv (p), AIPS++ code rename utility.
ao (p), AIPS++ code checkout utility.
ax (p), AIPS++ code deletion utility.
rau (p), update AIPS++ sources from the master via ssh(1).
sau (p), AIPS++ code update utility.
mktree (p), create AIPS++ directory hierarchy.

Author

Original: 1992/04/30 by Mark Calabretta, ATNF.