1 \chapter{Gestione di parametri e opzioni}
3 Il passaggio dei parametri e delle variabili di ambiente dalla riga di comando
4 al singolo programma quando viene lanciato è effettuato attraverso le
5 variabili \texttt{argc}, \texttt{argv}, queste vengono passate al programma
6 come argomenti della funzione principale:
9 main(int argc, char * argv[])
12 \section{Il formato dei parametri}
14 Il passaggio dei parametri al programma viene effettuato dalla shell, che si
15 incarica di leggere la linea di comando e di effettuarne la scansione (il
16 cosiddetto \textit{parsing}) per individuare le parole che la compongono,
17 ciascuna delle quali viene considerata un parametro; di default per
18 individuare le parole viene usato come separatore lo spazio (comportamento
19 modificabile attraverso il settaggio della variabile di ambiente IFS).
21 Nella scansione viene costruito l'array di puntatori \texttt{argv} inserendo
22 in successione il puntatore alla stringa costituente l'$n$-simo parametro; la
23 variabile \texttt{argc} viene inizializzata al numero di parametri trovati, in
24 questo modo il primo parametro è sempre il nome del programma (vedi \nfig).
26 \section{La gestione delle opzioni}
28 In generale un programma unix riceve da linea di comando sia i parametri che
29 le opzioni, queste ultime sono standardizzate per essere riconosciute come
30 tali: un elemento di \texttt{argv} che inizia con \texttt{-} e che non sia un
31 singolo \texttt{-} o \texttt{--} viene considerato un'opzione. In in genere
32 le opzioni sono costituite da un lettera preceduta dal meno e possono avere o
33 no un parametro associato; un comando tipico può essere cioè qualcosa del
36 touch -r riferimento.txt -m questofile.txt
38 ed in questo caso le opzioni sono \texttt{m} ed \texttt{r}.
40 Per gestire le opzioni all'interno dei parametri passati in \texttt{argv} le
41 librerie standard del C forniscono la funzione \texttt{getopt} (accessibile
42 includendo \texttt{unistd.h}), che ha il prototipo:
44 int getopt(int argc, char * const argv[], const char * optstring);
47 Questa funzione prende come argomenti le due variabili \texttt{argc} e
48 \texttt{argv} ed una stringa che indica quali sono le opzioni valide; la
49 funzione effettua la scansione della lista dei parametri ricercando ogni
50 stringa che comincia con \texttt{-} e ritorna ogni volta che trova una opzione
53 La stringa \texttt{optstring} indica quali sono le opzioni riconosciute ed è
54 costituita da tutti i caratteri usati per identificare le singole opzioni, se
55 l'opzione ha un parametro al carattere deve essere fatto seguire un segno di
56 due punti \texttt{:} nel caso appena accennato ad esempio la stringa di
57 opzioni sarebbe \texttt{"r:m"}.
59 La modalità di uso è pertanto quella di chiamare più volte la funzione
60 all'interno di un ciclo di while fintanto che essa non ritorna il valore
61 \texttt{-1} che indica che non ci sono più opzioni. Nel caso si incontri
62 un'opzione non dichiarata in \texttt{optstring} viene ritornato un \texttt{?}
63 mentre se l'opzione non è seguita da un parametro viene ritornato un
64 \texttt{:} infine se viene incontrato il valore \texttt{--} la scansione viene
67 Quando la funzione trova un'opzione essa ritorna il valore numerico del
68 carattere, in questo modo si possono prendere le azioni relative usando un
69 case; la funzione inizializza inoltre alcune varibili globali:
71 \item \texttt{char * optarg} contiene il puntatore alla stringa argomento
73 \item \texttt{int optind} alla fine della scansione restituisce l'indice del
74 primo argomento che non è un'opzione.
75 \item \texttt{int opterr} previene, se posto a zero, la stampa di un messaggio
76 di errore in caso di riconoscimento di opzioni non definite.
77 \item \texttt{int optopt} contiene il carattere dell'opzione non riconosciuta.
80 In \nfig è mostrato un programma di esempio,
85 opterr = 0; /* don't want writing to stderr */
86 while ( (i = getopt(argc, argv, "o:a:i:hve")) != -1) {
88 case 'i': /* input file */
89 in_file=open(optarg,O_RDONLY);
91 perror("Cannot open input file");
95 case 'o': /* output file (overwrite) */
96 out_file=open(optarg,O_WRONLY|O_CREAT);
98 perror("Cannot open output file");
103 case 'a': /* output file (append) */
104 out_file=open(optarg,O_WRONLY|O_CREAT|O_APPEND);
106 case 'h': /* print help usage */
109 case 'v': /* set verbose mode */
110 debug("Option -v active\n");
113 case '?': /* unrecognized options */
114 printf("Unrecognized options -%c\n",optopt);
116 default: /* should not reached */
117 debug("default option\n");
121 debug("Optind %d, argc %d\n",optind,argc);
123 \caption{Esempio di codice per la gestione delle opzioni.}
124 \label{fig:options_code}
128 \subsection{Opzioni in formato esteso}
130 Un'estensione di questo schema è costituito dalle cosiddette
131 \textit{long-options} espresse nella forma \texttt{--option=parameter}, anche
132 la gestione di queste ultime è stata standardizzata attraverso l'uso di una
133 versione estesa di \texttt{getopt}.
136 \section{Le variabili di ambiente}