Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

Subsections

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

am

Utility to change the descriptive text in an AIPS++ RCS version file.

Synopsis

am [-au] file1 [file2 ...]

Description

am changes the descriptive text in an existing AIPS++ RCS version file or files. It is a front-end for the RCS rcs command with option -t. The descriptive text will be obtained from stdin.

am 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 am must be simple filenames without path or RCS (,v) suffix. am determines the corresponding master directory from the current working directory.

am modifies the master RCS version file by executing $MSTRETCD/am_master, where $AIPSMSTR is expected to be NFS mounted from the AIPS++ master host (see §1.1.4).

Options

-au

After modifying the master RCS version file, am copies it back to the local slave RCS repository (if it exists), giving it a file ownership defined by the owner of am (aips2mgr at the local site). am itself must be setuid to this account.

Notes

• The RCS rcs command must have write permission on the version file in order to modify it. The file ownership is defined by the owner of $MSTRETCD/am_master (aips2adm). This script must have the setuid bit set (see chmod).

• While mktree (p) creates RCS symbolic links in the programmer directory hierarchy, these are not used by am. Their main function is to allow gmake (p) to automatically check out the makefile for a directory. They also allow RCS utilities such as alog (p) and rlog to be applied readily to the slave RCS repository. am does not make use of these RCS symbolic links but deals directly with the AIPS++ master repository by specifying absolute pathnames.

• Modifications are disabled if $MSTRETCD/ai_disable exists, see ai (p). If this file contains any text it will be printed as an informative message.

Diagnostics

Status return values
0: success
1: initialization error
2: failed to update the master
3: updated master, but slave not updated

Examples

The command

   cd $HOME/aips++/code/install/codemgmt
   am -au am

would allow the descriptive text for am to be changed interactively.

Bugs

• am 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).
ae (p), AIPS++ RCS semaphore file deletion utility.
ai (p), AIPS++ code checkin utility.
alog (p), AIPS++ change log reporting utility.
amv (p), AIPS++ code rename utility.
au (p), AIPS++ code update utility.
ax (p), AIPS++ code deletion utility.
mktree (p), create AIPS++ directory hierarchy.

Author

Original: 1995/03/17 by Mark Calabretta, ATNF.