view release on metacpan or  search on metacpan

pod/v2/afsperlvldb.pod  view on Meta::CPAN

   file server machine as the site for a volume: specify the
   PARTITION argument.

 * Every VLDB entry that mentions a certain partition on a
   certain file server machine as the site for a volume:
   combine the SERVER and PARTITION arguments.

If you set LOCK (default 0) to 1 it returns only locked VLDB
entries. This flag can be combined with the SERVER argument, the
PARTITION argument, or both.

It calls the AFS system library function I<VolumeInfoCmd>.

You can find an example how to print the entire content of the
returned hash reference in the C<examples/v2/vldb> directory.

=item B<$vldblist = $vldb-E<gt>listvldbentry(VOLUME);>

Returns information from the Volume Location Database (VLDB) entry for
the specified VOLUME (volume name or volume ID number).  The return
value is a reference to a hash table containing the values from the C
structure C<nvldbentry>.

It calls the AFS system library function I<VolumeInfoCmd>.

You can find an example how to print the entire content of the
returned hash reference in the C<examples/v2/vldb> directory.

=item B<$ok = $vldb-E<gt>lock(VOLUME);>

Locks the VLDB entry for VOLUME (volume name or volume ID number),
blocking any operation that requires a write to that entry. The lock
applies to all of the volume versions associated with the entry, not
just the one specified.  It calls the AFS system library function
I<VL_SetLock>.

=item B<$ok = $vldb-E<gt>removeaddr(IP);>

Removes from the VLDB the server entry that includes the address
specified by the IP argument.  It calls the AFS system library
function I<VL_ChangeAddr>.

=item B<$ok = $vldb-E<gt>remsite(SERVER, PARTITION, VOLUME);>

Removes the read-only replication site specified by the SERVER and
PARTITION arguments from the Volume Location Database (VLDB) entry for
the indicated read/write VOLUME.

This method is useful for removing read-only sites that were
mistakenly created with the I<addsite> method, before the volume was
actually released. If a read-only copy already exists at the site, it
is not affected. However, if this read-only site was the last site
housing any version of the volume, then the entire VLDB entry is
removed, even if a copy of the read-only version still actually exists
at the site.It calls the AFS system library function I<UV_RemoveSite>.

=item B<$ok = $vldb-E<gt>syncserv(SERVER [, PARTITION]);>

Verifies that each volume mentioned in a VLDB entry actually exists at
the site indicated in the entry. It checks all VLDB entries that
mention a read/write, read-only, or backup site either on any
partition on the file server machine specified by the SERVER argument,
or on the one partition specified by the SERVER and PARTITION
arguments.
It calls the AFS system library function I<UV_SyncServer>.

=item B<$ok = $vldb-E<gt>syncvldb(SERVER [, PARTITION]);>

Verifies that the status of the volumes housed either on all
partitions on the file server machine specified by the SERVER
argument, or on the single partition specified by the SERVER and
PARTITION arguments, is recorded correctly in the VLDB.  It calls the
AFS system library function I<UV_SyncVolume>.

=item B<$ok = $vldb-E<gt>syncvldbentry(VOLUME);>

Verifies that the status of the VOLUME is recorded correctly in the
VLDB.  It calls the AFS system library function I<UV_SyncVolume>.

=item B<$ok = $vldb-E<gt>unlock(VOLUME);>

Releases the lock on the VLDB entry for the specified VOLUME (volume
name or volume ID number).  It calls the AFS system library function
I<UV_LockRelease>.

=item B<$ok = $vldb-E<gt>unlockvldb([SERVER [, PARTITION]]);>

Releases the lock on the VLDB entries
indicated by the combination of arguments provided:

  * To unlock all entries in the VLDB, provide no arguments.

  * To unlock all entries that mention a file server machine
    in a site definition, provide its name with the SERVER
    argument.

  * To unlock all entries that mention a partition on any
    file server machine in a site definition, provide the
    partition name with the PARTITION argument.

  * To unlock all entries that mention a specific site,
    provide both the SERVER and PARTITION arguments.

It calls the AFS system library function I<VL_ReleaseLock>.

=back

=head1 AUTHORS

The code and documentation for this class were contributed by Stanford
Linear Accelerator Center, a department of Stanford University.  This
documentation were written by

=over

=item Alf Wachsmann E<lt>alfw@slac.stanford.eduE<gt>, and

=item Norbert E. Gruener E<lt>nog@MPA-Garching.MPG.deE<gt>

=item S< >