====== Specifica Progetto Appelli Giugno/Luglio 2019 ======

=== Descrizione === 
Sviluppare una applicazione di sistema Unix/Linux chiamata ''filestat'' che sia in grado di monitorare un insieme di file raccogliendo informazioni su:
  * dimensione (in byte);
  * permessi;
  * data ultimo accesso al file;
  * data ultima modifica del file;
  * data ultima modifica dei permessi;
  * numero di link al file;
  * proprietario;
  * gruppo.

Queste informazioni sono recuperabili usando le funzioni ''stat()'', ''lstat()'' e ''fstat()''. 

La sinossi del programma è:

<code>
filestat [options] [input] [output]
</code>

Dove:
  * ''input'' è il file di input dove vengono definiti i parametri di esecuzione del programma, se omesso viene usato il file ''filestat.in'';
  * ''output'' è il file di output dove vengono collezionati i dati raccolti, se omesso viene usato il file ''filestat.db''. Le informazioni presenti nel file di output vengono __aggiornate__ ad ogni esecuzione del programma (e non soprascritte). 

Le possibili opzioni sono:

<code>
--verbose|-v
--stat|-s
--report|-r
--history|-h <filepah>
--user|-u <userId>
--group|-g <groupId>
--length|-l <min>:<max>
--noscan
</code>

La descrizione è la seguente:
    * ''--verbose|-v'': durante l'esecuzione il programma mostra a video le informazioni sui file elaborati, ed i dati raccolti;
    * ''--stat|-s'': vengono mostrate sullo standard output le seguenti statistiche:
      - numero di file monitorati;
      - numero di link;
      - numero di directory;
      - dimensione totale;
      - dimensione media;
      - dimensione massima;
      - dimensione minima (in byte). 
    * ''--report|-r'': al termine dell'esecuzione vengono mostrati sullo standard output le informazioni riguardanti numero di file elaborati, tempo di elaborazione, dimensione massima del file;
    * ''--history|-h <filepah>'': stampa sullo standard output la cronologia delle informazioni riguardanti il file ''<filepah>'';
    * ''--user|-u <userId>'': stampa sullo standard output le informazioni di tutti i file di proprietà di ''<userId>''
    * ''--group|-g <groupId>'': stampa sullo standard output le informazioni di tutti i file di proprietà di ''<groupId>''
    * ''--length|-l <min>:<max>'': stampa sullo schermo le informazioni di tutti i file di dimensione (in byte) compresa tra ''<min>'' e ''<max>'' ('':<max>'' indica ogni file di dimensione al più ''<max>'', ''<min>:'' e ''<min>'' indicano ogni file di dimensione almeno ''<min>'')
    * ''--noscan'': se presente questa opzione non viene effettuata la raccolta dei dati, ma vengono presentati solo le informazioni presenti del file di output.  

=== Formato File di Input ===
I parametri di esecuzione di un programma vengono definiti in un file di testo costituito da una sequenza di righe della seguente forma:

<code>
<path> [r] [l]
</code>

Dove ''r'' indica che occorre leggere ricorsivamente i file nelle directory sottostanti (applicando le stesse opzioni) mentre ''l'' indica che i link devono essere trattati come file/directory regolari, in questo caso le informazioni collezionate fanno riferimento al file riferito dal link e non a link stesso.

=== Formato File di Outout ===

I dati raccolti vengono salvati usando il seguente formato:

<code>
# <path1>
<data1> <uid1> <gid1> <dim1> <perm1> <acc1> <change1> <mod1> <nlink1>
...
<data_n> <uid_n> <gid_n> <dim_n> <perm_n> <acc_n> <change_n> <mod_n> <nlink_n>
###
# <path2>
<data1> <uid1> <gid1> <dim1> <perm1> <acc1> <change1> <mod1> <nlink1>
...
<data_n> <uid_n> <gid_n> <dim_n> <perm_n> <acc_n> <change_n> <mod_n> <nlink_n>
###
...
# <pathm>
<data1> <uid1> <gid1> <dim1> <perm1> <acc1> <change1> <mod1> <nlink1>
...
<data_n> <uid_n> <gid_n> <dim_n> <perm_n> <acc_n> <change_n> <mod_n> <nlink_n>
###
###
</code>

Le informazioni associate al file/directory ''<path>'' iniziano con la riga:

<code>
# <path>
</code>

Successivamente si trovano una sequenza di righe (una per ogni analisi svolta) della forma:

<code>
<data> <uid> <gid> <dim> <perm> <acc> <change> <mod> <nlink>
</code>

Dove:
  * ''<data>'' indica ora-data in cui sono recuperate le informazioni;
  * ''<uid>'' è l'id dell'utente proprietario del file;
  * ''<gid>'' è l'id del gruppo del file;
  * ''<perm>'' è la stringa con i diritti di accesso al file;
  * ''<acc>'' data dell'ultimo accesso;
  * ''<change>'' data dell'ultimo cambiamento;
  * ''<mod>'' data dell'ultima modifica dei permessi;
  * ''<nlink>'' numero di link verso il file.

Le informazioni terminano con la riga:

<code>
###
</code>


Il file termina con una riga

<code>
###
</code>

====== Addendum per 12 CFU ======

Gli studenti che devono sostenere il programma di Sistemi Operativi con 12CFU devono implementare anche il server ''filetatd'' che raccoglie informazioni da più client. Inoltre, il programma ''filestat'' potrà prendere come parametri aggiuntivi ''<host> <port>'' che identifica il server a cui inviare le informazioni. In questo caso tutte le informazioni non vengono salvate localmente ma inviate al server. Allo stesso modo le eventuali richiesta di informazioni devono essere recuperate dal server.
  

----