chiark - git - mdw - dpkg/blob - man/it/update-alternatives.man

   1 .\" dpkg manual page - update-alternatives(1)
   2 .\"
   3 .\" Copyright © 1997-1998 Charles Briscoe-Smith
   4 .\" Copyright © 1999 Ben Collins <bcollins@debian.org>
   5 .\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org>
   6 .\" Copyright © 2003 Adam Heath <doogie@debian.org>
   7 .\" Copyright © 2005 Scott James Remnant <scott@netsplit.com>
   8 .\" Copyright © 2006-2015 Guillem Jover <guillem@debian.org>
   9 .\" Copyright © 2008 Pierre Habouzit <madcoder@debian.org>
  10 .\" Copyright © 2009-2011 Raphaël Hertzog <hertzog@debian.org>
  11 .\"
  12 .\" This is free software; you can redistribute it and/or modify
  13 .\" it under the terms of the GNU General Public License as published by
  14 .\" the Free Software Foundation; either version 2 of the License, or
  15 .\" (at your option) any later version.
  16 .\"
  17 .\" This is distributed in the hope that it will be useful,
  18 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  19 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20 .\" GNU General Public License for more details.
  21 .\"
  22 .\" You should have received a copy of the GNU General Public License
  23 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
  24 .
  25 .\"*******************************************************************
  26 .\"
  27 .\" This file was generated with po4a. Translate the source file.
  28 .\"
  29 .\"*******************************************************************
  30 .TH update\-alternatives 1 %RELEASE_DATE% %VERSION% "suite dpkg"
  31 .nh
  32 .SH NOME
  33 update\-alternatives \- mantiene collegamenti simbolici che determinano i
  34 comandi predefiniti
  35 .
  36 .SH SINTASSI
  37 \fBupdate\-alternatives\fP [\fIopzione\fP...] \fIcomando\fP
  38 .
  39 .SH DESCRIZIONE
  40 \fBupdate\-alternatives\fP crea, rimuove, mantiene e visualizza informazioni sui
  41 collegamenti simbolici che costituiscono il sistema di alternative di
  42 Debian.
  43 .PP
  44 È possibile che in un dato momento nel sistema siano installati più
  45 programmi che hanno la stessa funzione o una funzione simile. Per esempio,
  46 molti sistemi hanno diversi editor di testo installati
  47 contemporaneamente. Questo dà agli utenti del sistema una possibilità di
  48 scelta, permettendo a ciascuno di usare un editor diverso, se lo desidera,
  49 ma rende difficile per un programma fare una buona scelta quando deve
  50 invocare un editor se l'utente non ha impostato una preferenza specifica.
  51 .PP
  52 Il sistema delle alternative Debian mira a risolvere questo problema. Nel
  53 file system tutti i file che forniscono una funzionalità intercambiabile
  54 condividono un nome generico. Il sistema delle alternative e
  55 l'amministratore di sistema insieme determinano a quale file faccia
  56 effettivamente riferimento questo nome generico. Per esempio, se sul sistema
  57 sono installati entrambi gli editor di testo \fBed\fP(1) e \fBnvi\fP(1), il
  58 sistema delle alternative farà sì che il nome generico \fI/usr/bin/editor\fP
  59 faccia in modo predefinito riferimento a \fI/usr/bin/nvi\fP. L'amministratore
  60 di sistema può sovrascrivere ciò e far sì che esso faccia invece riferimento
  61 a \fI/usr/bin/ed\fP, e il sistema delle alternative non modificherà questa
  62 impostazione se ciò non viene esplicitamente richiesto.
  63 .PP
  64 Il nome generico non è un collegamento simbolico diretto all'alternativa
  65 selezionata. È invece un collegamento simbolico a un nome nella \fIdirectory\fP
  66 \fIalternatives\fP, che è a sua volta un collegamento simbolico all'effettivo
  67 file referenziato. Tutto questo perché così le modifiche fatte
  68 dall'amministratore di sistema possono rimanere confinate nella directory
  69 \fI/etc\fP: il FHS (q.v.) spiega le ragioni per cui questa è una Cosa Buona e
  70 Giusta.
  71 .PP
  72 Al momento dell'installazione, cambiamento o rimozione di ogni pacchetto che
  73 fornisce un file con una particolare funzionalità, viene invocato
  74 \fBupdate\-alternatives\fP per aggiornare le informazioni su quel file nel
  75 sistema delle alternative. \fBupdate\-alternatives\fP viene solitamente chiamato
  76 dagli script \fBpostinst\fP (configurazione) o \fBprerm\fP (rimozione e
  77 deconfigurazione) dei pacchetti Debian.
  78 .PP
  79 Spesso è utile che un certo numero di alternative siano sincronizzate, in
  80 modo da venir modificate in gruppo; per esempio, quando sono installate
  81 diverse versioni dell'editor \fBvi\fP(1), la pagina di manuale a cui fa
  82 riferimento \fI/usr/share/man/man1/vi.1\fP dovrebbe corrispondere
  83 all'eseguibile a cui fa riferimento \fI/usr/bin/vi\fP. \fBupdate\-alternatives\fP
  84 gestisce questo usando collegamenti \fIprincipali\fP e \fIsecondari\fP; quando
  85 viene modificato il principale, anche tutti i secondari ad esso associati
  86 vengono modificati. Un collegamento principale e tutti i suoi secondari
  87 associati compongono un \fIgruppo di\fP \fIcollegamenti\fP.
  88 .PP
  89 In qualsiasi momento, ogni gruppo di collegamenti è in una di due modalità:
  90 automatica o manuale. Quando un gruppo è in modalità automatica, il sistema
  91 delle alternative deciderà automaticamente se e come aggiornare i
  92 collegamenti quando i pacchetti vengono installati o rimossi. In modalità
  93 manuale, il sistema delle alternative preserva le scelte dell'amministratore
  94 ed evita di modificare i collegamenti (tranne quando qualcosa non è
  95 corretto).
  96 .PP
  97 I gruppi di collegamenti sono inizialmente in modalità automatica, quando
  98 vengono introdotti nel sistema. Se l'amministratore del sistema fa modifiche
  99 alle impostazioni automatiche del sistema, queste verranno notate alla
 100 successiva esecuzione di \fBupdate\-alternatives\fP sul gruppo di collegamenti
 101 modificato e il gruppo automaticamente verrà passato alla modalità manuale.
 102 .PP
 103 Ogni alternativa è associata ad una \fIpriorità\fP. Quando un gruppo di
 104 collegamenti è in modalità automatica, le alternative a cui puntano i membri
 105 del gruppo saranno quelle con la priorità più alta.
 106 .PP
 107 When using the \fB\-\-config\fP option, \fBupdate\-alternatives\fP will list all of
 108 the choices for the link group of which given \fIname\fP is the master
 109 alternative name.  The current choice is marked with a ‘*’.  You will then
 110 be prompted for your choice regarding this link group.  Depending on the
 111 choice made, the link group might no longer be in \fIauto\fP mode. You will
 112 need to use the \fB\-\-auto\fP option in order to return to the automatic mode
 113 (or you can rerun \fB\-\-config\fP and select the entry marked as automatic).
 114 .PP
 115 Se si vuole fare la configurazione in modo non interattivo, si può usare
 116 invece l'opzione \fB\-\-set\fP (vedere in seguito).
 117 .PP
 118 Pacchetti diversi che forniscono lo stesso file devono farlo
 119 \fBcooperando\fP. In altre parole, l'uso di \fBupdate\-alternatives\fP è
 120 \fBobbligatorio\fP per tutti i pacchetti coinvolti in un caso simile. Non è
 121 possibile sovrascrivere un file in un pacchetto che non utilizza il
 122 meccanismo \fBupdate\-alternatives\fP.
 123 .
 124 .SH TERMINOLOGIA
 125 Dato che le attività di \fBupdate\-alternatives\fP sono piuttosto convolute,
 126 alcuni termini specifici aiutano a spiegare il suo funzionamento.
 127 .TP
 128 nome generico (o collegamento dell'alternativa)
 129 Un nome, come \fI/usr/bin/editor\fP, che fa riferimento, utilizzando il sistema
 130 delle alternative, ad uno di svariati file con funzione similare.
 131 .TP
 132 nome dell'alternativa
 133 Il nome di un collegamento simbolico nella directory delle alternative.
 134 .TP
 135 alternativa (o percorso alternativo)
 136 Il nome di uno specifico file nel file system, che può essere reso
 137 accessibile attraverso un nome generico utilizzando il sistema delle
 138 alternative.
 139 .TP
 140 directory delle alternative
 141 Una directory, in modo predefinito \fI%CONFDIR%/alternatives\fP, che contiene i
 142 collegamenti simbolici.
 143 .TP
 144 directory di amministrazione
 145 Una directory, in modo predefinito \fI%ADMINDIR%/alternatives\fP, che contiene
 146 le informazioni di stato di \fBupdate\-alternatives\fP.
 147 .TP
 148 gruppo di collegamenti
 149 Un insieme di collegamenti simbolici correlati, pensato per essere
 150 aggiornato in gruppo.
 151 .TP
 152 collegamento principale
 153 Il collegamento dell'alternativa, in un gruppo di collegamenti, che
 154 determina come sono configurati gli altri collegamenti nel gruppo
 155 .TP
 156 collegamento secondario
 157 Un collegamento dell'alternativa, in un gruppo di collegamenti, che è
 158 controllato dall'impostazione del collegamento principale.
 159 .TP
 160 modalità automatica
 161 Quando un gruppo di collegamenti è in modalità automatica, il sistema delle
 162 alternative assicura che i collegamenti nel gruppo puntino all'alternativa
 163 con la priorità più alta appropriata per il gruppo.
 164 .TP
 165 modalità manuale
 166 Quando un gruppo di collegamenti è in modalità manuale, il sistema delle
 167 alternative non fa alcuna modifica alle impostazioni dell'amministratore di
 168 sistema.
 169 .
 170 .SH COMANDI
 171 .TP
 172 \fB\-\-install\fP \fIcollegamento nome percorso priorità\fP [\fB\-\-slave\fP \fIcollegamento nome percorso\fP]...
 173 Aggiunge un gruppo di alternative al sistema. \fIcollegamento\fP è il nome
 174 generico del collegamento principale, \fInome\fP è il nome del suo collegamento
 175 simbolico nella directory delle alternative e \fIpercorso\fP è l'alternativa
 176 che viene introdotta per il collegamento principale. Gli argomenti che
 177 seguono \fB\-\-slave\fP sono il nome generico, il nome del collegamento simbolico
 178 nella directory delle alternative e il percorso dell'alternativa per un
 179 collegamento secondario. Possono essere specificate zero o più opzioni
 180 \fB\-\-slave\fP, ciascuna fatta seguire da tre argomenti. Notare che
 181 l'alternativa principale deve esistere o la chiamata non avrà
 182 successo. Tuttavia, se un'alternativa secondaria non esiste, il collegamento
 183 corrispondente semplicemente non verrà installato (verrà comunque
 184 visualizzato un messaggio di avvertimento). Se dove deve essere installato
 185 un collegamento di un'alternativa è installato un qualche file reale, esso
 186 viene conservato, a meno che non venga usata l'opzione \fB\-\-force\fP.
 187 .IP
 188 Se il nome dell'alternativa specificato esiste già nel registro del sistema
 189 delle alternative, le informazioni fornite verranno aggiunte come un nuovo
 190 insieme di alternative per il gruppo. Altrimenti viene aggiunto un nuovo
 191 gruppo con queste informazioni, impostato in modalità automatica. Se il
 192 gruppo è in modalità automatica, e la priorità delle alternative appena
 193 aggiunte è più alta di qualsiasi altra alternativa installata per questo
 194 gruppo, i collegamenti simbolici verranno aggiornati per puntare alle
 195 alternative appena aggiunte.
 196 .TP
 197 \fB\-\-set\fP \fInome percorso\fP
 198 Imposta il programma \fIpercorso\fP come alternativa per \fInome\fP. È equivalente
 199 a \fB\-\-config\fP ma non è interattivo e perciò è utilizzabile in script.
 200 .TP
 201 \fB\-\-remove\fP \fInome percorso\fP
 202 Rimuove un'alternativa e tutti i collegamenti secondari associati. \fInome\fP è
 203 il nome nella directory delle alternative e \fIpercorso\fP è un nome file
 204 assoluto a cui può essere collegato \fInome\fP. Se \fInome\fP è in effetti
 205 collegato a \fIpercorso\fP, \fInome\fP sarà aggiornato in modo da puntare ad
 206 un'altra alternativa appropriata (e il gruppo verrà rimesso in modalità
 207 automatica), oppure rimosso se non c'è più alcuna alternativa corretta. I
 208 collegamenti secondari associati verranno analogamente aggiornati o
 209 rimossi. Se il collegamento attualmente non punta a \fIpercorso\fP, non verrà
 210 modificato alcun collegamento; verranno solamente rimosse le informazioni
 211 riguardanti l'alternativa.
 212 .TP
 213 \fB\-\-remove\-all\fP \fInome\fP
 214 Rimuove tutte le alternative e tutti i loro collegamenti secondari
 215 associati. \fInome\fP è un nome nella directory delle alternative.
 216 .TP
 217 \fB\-\-all\fP
 218 Invoca \fB\-\-config\fP su tutte le alternative. Può essere proficuamente
 219 combinato con \fB\-\-skip\-auto\fP per rivedere e configurare tutte le alternative
 220 che non sono configurate in modalità automatica. Vengono mostrate anche le
 221 alternative non corrette. Perciò un modo semplice per correggere tutte le
 222 alternative difettose è di chiamare \fByes \*(rq | update\-alternatives \-\-force
 223 \-\-all\fP.
 224 .TP
 225 \fB\-\-auto\fP \fInome\fP
 226 Fa passare in modalità automatica il gruppo di collegamenti relativo
 227 all'alternativa per \fInome\fP. Nel fare ciò, il collegamento simbolico
 228 principale e i suoi collegamenti secondari sono aggiornati in modo da
 229 puntare alle alternative installate con la priorità più alta.
 230 .TP
 231 \fB\-\-display\fP \fInome\fP
 232 Display information about the link group.  Information displayed includes
 233 the group's mode (auto or manual), the master and slave links, which
 234 alternative the master link currently points to, what other alternatives are
 235 available (and their corresponding slave alternatives), and the highest
 236 priority alternative currently installed.
 237 .TP
 238 \fB\-\-get\-selections\fP
 239 List all master alternative names (those controlling a link group)  and
 240 their status (since version 1.15.0).  Each line contains up to 3 fields
 241 (separated by one or more spaces). The first field is the alternative name,
 242 the second one is the status (either \fBauto\fP or \fBmanual\fP), and the last one
 243 contains the current choice in the alternative (beware: it's a filename and
 244 thus might contain spaces).
 245 .TP
 246 \fB\-\-set\-selections\fP
 247 Read configuration of alternatives on standard input in the format generated
 248 by \fB\-\-get\-selections\fP and reconfigure them accordingly (since version
 249 1.15.0).
 250 .TP
 251 \fB\-\-query\fP \fInome\fP
 252 Display information about the link group like \fB\-\-display\fP does, but in a
 253 machine parseable way (since version 1.15.0, see section \fBQUERY FORMAT\fP
 254 below).
 255 .TP
 256 \fB\-\-list\fP \fInome\fP
 257 Visualizza tutte le destinazioni del gruppo di collegamenti
 258 .TP
 259 \fB\-\-config\fP \fInome\fP
 260 Visualizza le alternative disponibili per un gruppo di collegamenti e
 261 permette all'utente di selezionare in modo interattivo quale usare. Il
 262 gruppo di collegamenti viene aggiornato.
 263 .TP
 264 \fB\-\-help\fP
 265 Mostra il messaggio sull'uso ed esce.
 266 .TP
 267 \fB\-\-version\fP
 268 Mostra la versione ed esce.
 269 .
 270 .SH OPZIONI
 271 .TP
 272 \fB\-\-altdir\fP\fI directory\fP
 273 Specifica la directory delle alternative, quando deve essere diversa da
 274 quella predefinita.
 275 .TP
 276 \fB\-\-admindir\fP\fI directory\fP
 277 Specifica la directory di amministrazione, quando deve essere diversa da
 278 quella predefinita.
 279 .TP
 280 \fB\-\-log\fP\fI file\fP
 281 Specifies the log file (since version 1.15.0), when this is to be different
 282 from the default (%LOGDIR%/alternatives.log).
 283 .TP
 284 \fB\-\-force\fP
 285 Allow replacing or dropping any real file that is installed where an
 286 alternative link has to be installed or removed.
 287 .TP
 288 \fB\-\-skip\-auto\fP
 289 Salta la richiesta di input sulla configurazione per le alternative che sono
 290 configurate in modo corretto in modalità automatica. Questa opzione è
 291 rilevante solo con \fB\-\-config\fP o \fB\-\-all\fP.
 292 .TP
 293 \fB\-\-verbose\fP
 294 Generate more comments about what is being done.
 295 .TP
 296 \fB\-\-quiet\fP
 297 Non genera alcun commento a meno che non si verifichi un errore.
 298 .
 299 .SH "STATO D'USCITA"
 300 .TP
 301 \fB0\fP
 302 L'azione richiesta è stata effettuata con successo.
 303 .TP
 304 \fB2\fP
 305 Si sono verificati dei problemi nell'analisi della riga di comando o
 306 nell'effettuare l'azione.
 307 .
 308 .SH AMBIENTE
 309 .TP
 310 \fBDPKG_ADMINDIR\fP
 311 Se impostata e l'opzione \fB\-\-admindir\fP non è stata specificata, verrà usata
 312 come directory di amministrazione di base.
 313 .
 314 .SH FILE
 315 .TP
 316 \fI%CONFDIR%/alternatives/\fP
 317 La directory delle alternative predefinita. La directory considerata può
 318 essere modificata usando l'opzione \fB\-\-altdir\fP.
 319 .TP
 320 \fI%ADMINDIR%/alternatives/\fP
 321 La directory di amministrazione predefinita. La directory considerata può
 322 essere modificata usando l'opzione \fB\-\-admindir\fP.
 323 .
 324 .SH "FORMATO DI QUERY"
 325 The \fB\-\-query\fP format is using an RFC822\-like flat format. It's made of \fIn\fP
 326 + 1 blocks where \fIn\fP is the number of alternatives available in the queried
 327 link group. The first block contains the following fields:
 328 .TP
 329 \fBName:\fP\fI nome\fP
 330 Il nome dell'alternativa nella directory delle alternative.
 331 .TP
 332 \fBLink:\fP\fI collegamento\fP
 333 Il nome generico dell'alternativa.
 334 .TP
 335 \fBSlaves:\fP\fI elenco di collegamenti secondari\fP
 336 Quando è presente questo campo, le righe \fBsuccessive\fP contengono tutti i
 337 collegamenti secondari associati con il collegamento principale
 338 dell'alternativa, uno per riga. Ogni riga contiene uno spazio, il nome
 339 generico dell'alternativa secondaria, un altro spazio e il percorso del
 340 collegamento secondario.
 341 .TP
 342 \fBStatus:\fP\fI stato\fP
 343 Lo stato dell'alternativa (\fBauto\fP o \fBmanual\fP).
 344 .TP
 345 \fBBest:\fP\fI scelta\-migliore\fP
 346 Il percorso all'alternativa migliore per questo gruppo di collegamenti; non
 347 è presente se non c'è alcuna alternativa disponibile.
 348 .TP
 349 \fBValue:\fP\fI alternativa\-attualmente\-selezionata\fP
 350 Il percorso dell'alternativa attualmente selezionata. Può anche avere il
 351 valore magico \fBnone\fP. Viene usato se il collegamento non esiste.
 352 .PP
 353 Gli altri blocchi descrivono le alternative disponibili nel gruppo di
 354 collegamenti interrogato:
 355 .TP
 356 \fBAlternative:\fP\fI percorso\-di\-questa\-alternativa\fP
 357 Percorso dell'alternativa di questo blocco.
 358 .TP
 359 \fBPriority:\fP\fI valore\-priorità\fP
 360 Valore della priorità di questa alternativa.
 361 .TP
 362 \fBSlaves:\fP\fI elenco di collegamenti secondari\fP
 363 Quando è presente questo campo, le righe \fBsuccessive\fP contengono tutte le
 364 alternative secondarie associate con il collegamento principale
 365 dell'alternativa, uno per riga. Ogni riga contiene uno spazio, il nome
 366 generico dell'alternativa secondaria, un altro spazio e il percorso
 367 dell'alternativa secondaria.
 368 .
 369 .SS Example
 370 .nf
 371 $ update\-alternatives \-\-query editor
 372 Name: editor
 373 Link: /usr/bin/editor
 374 Slaves:
 375  editor.1.gz /usr/share/man/man1/editor.1.gz
 376  editor.fr.1.gz /usr/share/man/fr/man1/editor.1.gz
 377  editor.it.1.gz /usr/share/man/it/man1/editor.1.gz
 378  editor.pl.1.gz /usr/share/man/pl/man1/editor.1.gz
 379  editor.ru.1.gz /usr/share/man/ru/man1/editor.1.gz
 380 Status: auto
 381 Best: /usr/bin/vim.basic
 382 Value: /usr/bin/vim.basic
 383
 384 Alternative: /bin/ed
 385 Priority: \-100
 386 Slaves:
 387  editor.1.gz /usr/share/man/man1/ed.1.gz
 388
 389 Alternative: /usr/bin/vim.basic
 390 Priority: 50
 391 Slaves:
 392  editor.1.gz /usr/share/man/man1/vim.1.gz
 393  editor.fr.1.gz /usr/share/man/fr/man1/vim.1.gz
 394  editor.it.1.gz /usr/share/man/it/man1/vim.1.gz
 395  editor.pl.1.gz /usr/share/man/pl/man1/vim.1.gz
 396  editor.ru.1.gz /usr/share/man/ru/man1/vim.1.gz
 397 .fi
 398 .
 399 .SH DIAGNOSTICA
 400 Con \fB\-\-verbose\fP, \fBupdate\-alternatives\fP si dilunga sul suo standard output
 401 in modo incessante su cosa sta facendo. Se si verificano dei problemi,
 402 \fBupdate\-alternatives\fP produce in output messaggi di errore nel suo canale
 403 dello standard error e restituisce uno stato di uscita 2. Questi messaggi
 404 diagnostici dovrebbero essere autoesplicativi; se non li si ritiene tali,
 405 segnalare la cosa come un bug.
 406 .
 407 .SH ESEMPI
 408 Ci sono svariati pacchetti che forniscono un editor di testo compatibile con
 409 \fBvi\fP, per esempio \fBnvi\fP e \fBvim\fP. Quello da usarsi è controllato dal
 410 gruppo di collegamenti \fBvi\fP, che include i collegamenti per il programma
 411 stesso e per la pagina di manuale associata.
 412 .PP
 413 Per visualizzare tutti i pacchetti disponibili che forniscono \fBvi\fP e la sua
 414 impostazione attuale, usare l'azione \fB\-\-display\fP:
 415 .PP
 416 .RS
 417 \fBupdate\-alternatives \-\-display vi\fP
 418 .RE
 419 .PP
 420 Per scegliere una particolare implementazione di \fBvi\fP, usare questo comando
 421 da root e poi selezionare un numero dall'elenco:
 422 .PP
 423 .RS
 424 \fBupdate\-alternatives \-\-config vi\fP
 425 .RE
 426 .PP
 427 Per ritornare alla scelta automatica dell'implementazione di \fBvi\fP, usare
 428 questo da root:
 429 .PP
 430 .RS
 431 \fBupdate\-alternatives \-\-auto vi\fP
 432 .RE
 433 .
 434 .SH "VEDERE ANCHE"
 435 \fBln\fP(1), FHS: lo standard per la gerarchia del file system.