mtpt

(Display the mount point of a given AFS volume)

SYNOPSIS

mtpt [-hv] volume [volume ...]

mtpt -c

DESCRIPTION

mtpt looks up the provided AFS volumes in a central database of mappings from volume names to mount points and prints the corresponding mount points. It relies on a database that must be maintained whenever new volumes are created or the canonical mount point of a volume is changed.

The database format only knows about one mount point per volume, so if a given volume is mounted in multiple places, only one of those locations will be returned (whichever one is recorded in the database).

OPTIONS

-c, --count

Don't look up any volumes. Instead, just display the total count of entries in the database.

-h, --help

Print out this documentation (which is done simply by feeding the script to perldoc -t).

-v, --version

Print out the version of mtpt and exit.

EXAMPLES

Show the mount point for users.rra:

    mtpt users.rra

Show the mount points for both ls.trip.nntp and ls.trip.news:

    mtpt ls.trip.nntp ls.trip.news

FILES

/afs/ir/service/afs/data/mountpoints/mountpoints.db

The default location of the mount point database where mount point mappings are looked up. This will use whatever database format that the DB_File that comes with Perl uses.

BUGS

This program doesn't lock the database. It really should, since it may well return inconsistent results otherwise if someone else is also storing a mount point at the same time. However, in extensive use of this program and related programs, I've never seen that happen. Strange.

Nonetheless, at some point locking needs to be added to all of the programs that manipulate the mount point database. The only reason why this has not yet been done is that cleanmtpts can take hours to run and I want to be able to run it without locking all other users out of the database in the meantime.

SEE ALSO

loadmtpt(1), cleanmtpts(1)

The current version of this program and the loadmtpt and cleanmtpts utilities are available from their web page at <http://www.eyrie.org/~eagle/software/afs-mount/>.

AUTHORS

Neil Crellin <neilc@stanford.edu> and Russ Allbery <rra@stanford.edu>.

COPYRIGHT AND LICENSE

Copyright 1999, 2004 Board of Trustees, Leland Stanford Jr. University.

This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.

Last spun 2022-12-12 from POD modified 2008-07-28