Breve documentazione sullo script perl volstat.pl

Il programma volstat.pl e' un perl script che fornisce varie informazioni 
sulla situazione dei volumi di una cella afs. L'ho scritto di getto 
nell'estate del 2000 perche' non ho trovato nessun tool simile che mi 
soddisfaceva.
Nota: Essendo stato scritto di "getto" il debugging subito dal programma
e' stato molto "aleatorio", cioe' e' stato corretto man mano che gli 
errori si presentavano e manca una rilevazione puntuale di possibili 
situazioni di errore!

Per far funzionare correttamente lo script occorre modificare la variabile 
$MYCELL ad inizio programma con il nome della cella su cui si vuole operare.
E' inoltre possibile definire la variabile $NODOM per includere o meno
il dominio di appartenenza degli hostnames.
Nota: Se la cella ha server su domini diversi ma con nomi omonimi 
(ad esempio, afs1.sez1.pippo.com e afs1.sez2.pippo.com) escludendo il 
nome del dominio i calcoli sugli spazi disponibili/occupati vengono falsati.
In effetti quando ho scritto il pgm l'ho fatto su misura della cella
lnf.infn.it e quindi non avevo avuto problemi anche escludendo il 
dominio.

Se pensate possa tornare utile provatelo e mandate suggerimenti, commenti
e correzione a Sandro.Angius@lnf.infn.it

USO E SINTASSI

Un sommario della sintassi accettata dallo script e':

    Usage: volstat.pl [-help] [-summary] [-backup] [-readonly] [-noheader] 
           [-file <filename>|-regexp <regexp>|-pipe|-all|-server <server> [partition]|volume_name ...]

Dove i vari switch hanno il seguente significato:

   -help       Fornisce l'usage sopraindicato;

   -summary    Fornisce un sommario dello spazio occupato dai volumi che sono
               stati selezionati. I campi mostrati sono:

                Srv/Part    Server AFS e Partizione
                RUsed(Kb)   Blocchi totali usati nella partizione
                LUsed(Kb)   Blocchi usati dai volumi listati
                Quota(Kb)   Blocchi allocati ai volumi listati
                Blocks(Kb)  Blocchi totali della partizione
                RU%         Percentuale blocchi usati/liberi (partizione)
                LU%         Percentuale blocchi usati/liberi (volumi listati)
                Q%          Percentuale blocchi allocati/totali (volumi listati)
                *           Se presente: ci sono volumi a quota illimitata

   -backup     Mostra le informazioni relative anche ai volumi di backup;
   -readonly   Mostra le informazioni relative anche alle repliche readonly;
   -noheader   Elimina gli header nell'output;
   -file <filename>  
               Utilizza <filename> come lista dei volumi da esaminare
               (text file con un nome di volume per riga);
   -regexp <regexp>
               Permette di selezionare i volumi tramite una regular expression
               (la sintassi e' quella usata dalle regular expression di perl);               
   -pipe       Usa come lista dei volumi da esaminare l'output di un altro
               programma (un nome di volume per riga);
   -all        Tutti i volumi elencati da vos listvldb;
   -server <server> [partition]
               Seleziona i soli volumi presenti sul server e sulla partizione
	       (opzionale) indicati;
   volume_name ...
               Elenco, separato da spazi, dei volumi da elencare.

Esempi:

   Informazioni sui volumi che contengono la stringa "ang":

   % volstat.pl -summary -regexp ".*ang.*"

   Risultato:

Volume               ID         Server/Part TY  QUOTA(Kb)   %Q.   Qx. RO BK CDate    UDate    St. Accesses

user.angarano        1042897613 afspg/c     RW     150000    60    15  N  Y 19991029 20010531 On      3158
user.angius          1042893759 afscnaf/a   RW     310000     2    14  N  Y 19970116 20010510 On         0
user.desangro        1042894868 bearclaw/e  RW     200000    13    79  N  Y 19970710 20010428 On         1
user.wang            1042900691 afspg/c     RW      50000     0    45  N  Y 19991209 20000518 On         8


Srv/Part    RUsed(Kb)  LUsed(Kb)  Quota(Kb) Blocks(Kb)   RU%   LU%    Q%

afscnaf/a    11071696       6834     310000   15528071    71     0     1 
afspg/c       5486025      90682     200000    7757362    70     1     2 
bearclaw/e     718372      26387     200000   16675612     4     0     1 

---------------------------------------------------------------------------
Total:       17276093     123903     710000   39961045    43     0     1 

Dove il primo header ha il seguente significato:

   Volume       Nome volume
   ID           Id volume
   Server/Part  Server e partizione
   TY           Tipo volume (Read-Write, Read-Only, Backup)
   QUOTA(Kb)    Quota associata al volume
   %Q.          Percentuale quota occupata.
                In caso di volume a quota indefinita viene indicata
                (racchiusa tra parentesi) la percentuale rispetto allo spazio
                della partizione interessata.
   Qx.          Fattore "di crescita" disponibile per la quota 
                In caso di volume a quota indefinita viene indicata
                (racchiusa tra parentesi) il fattore rispetto alla spazio
                della partizione interessata. Ad esempio 2 indica la 
                possibilita' di raddoppiare la quota.
                (>> significa piu' di 99 volte)
   RO           Esistenza di repliche readonly
   BK           Esistenza di volumi di backup
   CDate        Data creazione volume
   UDate        Data update volume
   St.          Stato volume: On-line o Off-line
   Accesses     Accessi nell'ultimo giorno