.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "dpkg-split 1"
.TH dpkg-split 1 "2023-05-11" "1.21.22" "dpkg suite"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NOME"
.IX Header "NOME"
dpkg-split \- strumento per suddividere/unire archivi di pacchetto Debian
.SH "SINTASSI"
.IX Header "SINTASSI"
\&\fBdpkg-split\fR [\fIopzione\fR...] \fIcomando\fR
.SH "DESCRIZIONE"
.IX Header "DESCRIZIONE"
\&\fBdpkg-split\fR suddivide i file dei pacchetti binari Debian in parti pi\(`u piccole e li riassembla, per permettere l'archiviazione di grandi file di pacchetto su supporti piccoli, come floppy disk.
.PP
Pu\(`o essere utilizzato manualmente usando le opzioni \fB\-\-split\fR, \fB\-\-join\fR e \fB\-\-info\fR.
.PP
Ha anche una modalit\(`a automatica, invocata usando l'opzione \fB\-\-auto\fR, con la quale mantiene una coda di parti viste ma non ancora riassemblate, e riassembla un file di pacchetto quando ha visto tutte le sue parti. Le opzioni \fB\-\-listq\fR e \fB\-\-discard\fR permettono la gestione della coda.
.PP
Tutte le azioni di suddivisione, unione e gestione della coda producono messaggi informativi sullo standard output che possono essere ignorati senza problemi.
.SH "COMANDI"
.IX Header "COMANDI"
.IP "\fB\-s\fR, \fB\-\-split\fR \fIarchivio-completo\fR [\fIprefisso\fR]" 4
.IX Item "-s, --split archivio-completo [prefisso]"
Suddivide un singolo pacchetto binario Debian in pi\(`u parti.
.Sp
Le parti vengono chiamate \fIprefisso\fR\fB.\fR\fIN\fR\fBof\fR\fIM\fR\fB.deb\fR dove \fIN\fR \(`e il numero della parte, cominciando da 1, e \fIM\fR \(`e il numero totale delle parti (entrambi in forma decimale).
.Sp
Se non viene specificato un \fIprefisso\fR, allora viene usato il nome file \fIarchivio-completo\fR, inclusa la directory, rimuovendo qualsiasi parte \fB.deb\fR finale.
.IP "\fB\-j\fR, \fB\-\-join\fR \fIparte\fR..." 4
.IX Item "-j, --join parte..."
Unisce insieme le parti di un pacchetto, riassemblando il file originale cos\(`i come era prima che fosse suddiviso.
.Sp
I file delle parti specificati come argomenti devono rappresentare tutte le parti dello stesso identico file binario originale. Ogni parte deve essere presente una ed una sola volta nell'elenco degli argomenti, anche se non \(`e necessario che le parti siano elencate in ordine.
.Sp
Naturalmente, le parti devono essere state tutte generate specificando, al momento della suddivisione, la medesima dimensione delle parti, il che solitamente significa che devono essere state generate con la medesima invocazione di \fBdpkg-split \-\-split\fR.
.Sp
I nomi dei file delle parti non sono significativi per il processo di riassemblaggio.
.Sp
In modo predefinito il file di output si chiama \fIpacchetto\fR\fB_\fR\fIversione\fR\fB_\fR\fIarch\fR\fB.deb\fR.
.IP "\fB\-I\fR, \fB\-\-info\fR \fIparte\fR..." 4
.IX Item "-I, --info parte..."
Stampa informazioni, in un formato intelligibile, riguardo ai file delle parti specificati. Gli argomenti che non sono parti di un pacchetto binario producono invece un messaggio che informa della cosa (ma sempre sullo standard output).
.IP "\fB\-a\fR, \fB\-\-auto \-o\fR \fIcomplete-output\fR \fIpart\fR" 4
.IX Item "-a, --auto -o complete-output part"
Accoda automaticamente le parti e riassembla un pacchetto se ci\(`o \(`e possibile.
.Sp
La \fIparte\fR specificata viene esaminata e confrontata con altre parti dello stesso pacchetto (se presenti) nella coda delle parti dei file pacchetto.
.Sp
Se sono disponibili tutte le parti del file pacchetto a cui appartiene \fIparte\fR, allora il pacchetto viene riassemblato e scritto in \fIoutput-completo\fR (che normalmente non dovrebbe essere gi\(`a esistente, bench\('e ci\(`o non causi un errore).
.Sp
Altrimenti, la \fIparte\fR viene copiata nella coda e non viene creato \fIoutput-completo\fR.
.Sp
Se \fIparte\fR non \(`e una parte di un pacchetto binario suddiviso, allora \fBdpkg-split\fR terminer\(`a con lo stato \fB1\fR; se si verifica qualche altro problema allora terminer\(`a con lo stato \fB2\fR.
.Sp
Quando si usa \fB\-\-auto\fR deve essere specificata l'opzione \fB\-\-output\fR o \fB\-o\fR. (Se ci\(`o non fosse obbligatorio il programma che sta invocando l'azione non saprebbe quale file di output attendersi.)
.IP "\fB\-l\fR, \fB\-\-listq\fR" 4
.IX Item "-l, --listq"
Elenca il contenuto della coda dei pacchetti da riassemblare.
.Sp
Per ogni file di pacchetto per il quale esistono parti nella coda, l'output fornisce il nome del pacchetto, le parti nella coda e il numero totale di byte archiviati nella coda.
.IP "\fB\-d\fR, \fB\-\-discard\fR [\fIpacchetto\fR...]" 4
.IX Item "-d, --discard [pacchetto...]"
Questo scarta parti dalla coda di quelle in attesa delle parti restanti del proprio pacchetto.
.Sp
Se non viene specificato alcun \fIpacchetto\fR, allora la coda viene svuotata completamente; se ne \(`e specificato qualcuno, allora vengono eliminate solo le parti dei pacchetti indicati.
.IP "\fB\-?\fR, \fB\-\-help\fR" 4
.IX Item "-?, --help"
Mostra il messaggio sull'uso ed esce.
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
Mostra la versione ed esce.
.SH "OPZIONI"
.IX Header "OPZIONI"
.IP "\fB\-\-depotdir\fR \fIdirectory\fR" 4
.IX Item "--depotdir directory"
Specifies an alternative directory for the queue of parts awaiting automatic reassembly. The default is \fB/var/lib/dpkg/parts\fR.
.IP "\fB\-\-admindir\fR \fIdirectory\fR" 4
.IX Item "--admindir directory"
Set the administrative directory to \fIdirectory\fR (since dpkg 1.21.10).  This is where the \fIstatoverride\fR file is stored.  Defaults to \(Fo\fI/var/lib/dpkg\fR\(Fc if \fB\s-1DPKG_ADMINDIR\s0\fR has not been set.
.IP "\fB\-\-root\fR \fIdirectory\fR" 4
.IX Item "--root directory"
Set the root directory to \fBdirectory\fR (since dpkg 1.21.10), which sets the installation directory to \(Fo\fIdirectory\fR\(Fc and the administrative directory to \(Fo\fIdirectory\fR\fB/var/lib/dpkg\fR\(Fc if \fB\s-1DPKG_ROOT\s0\fR has not been set.
.IP "\fB\-S\fR, \fB\-\-partsize\fR \fIkibibyte\fR" 4
.IX Item "-S, --partsize kibibyte"
Specifica la dimensione massima, in kibibyte (1024 byte), delle parti quando viene fatta la suddivisione. Il valore predefinito \(`e 450 KiB.
.IP "\fB\-o\fR, \fB\-\-output\fR \fIoutput-completo\fR" 4
.IX Item "-o, --output output-completo"
Specifica il nome del file di output per il riassemblamento.
.Sp
Questo valore scavalca quello predefinito per il riassemblaggio manuale (\fB\-\-join\fR) ed \(`e obbligatorio per la messa in coda o il riassemblaggio automatici (\fB\-\-auto\fR).
.IP "\fB\-Q\fR, \fB\-\-npquiet\fR" 4
.IX Item "-Q, --npquiet"
Quando vengono fatti una messa in coda o un riassemblaggio automatici, \fBdpkg-split\fR stampa solitamente un messaggio se gli viene passata una \fIparte\fR che non \(`e una parte di un pacchetto binario. Questa opzione disabilita tali messaggi per permettere a programmi come \fBdpkg\fR di gestire sia pacchetti suddivisi sia non suddivisi, senza produrre messaggi spuri.
.IP "\fB\-\-msdos\fR" 4
.IX Item "--msdos"
Forces the output filenames generated by \fB\-\-split\fR to be MSDOS-compatible.
.Sp
Questo storpia il prefisso, o quello predefinito derivato dal nome file di input o quello fornito come argomento: i caratteri alfanumerici vengono resi minuscoli, i caratteri \(Fo+\(Fc vengono sostituiti da \fBx\fR e tutti gli altri caratteri vengono eliminati.
.Sp
Il risultato viene quindi troncato alla lunghezza necessaria e vengono generati nomi di file nella forma \fIprefissoN\fR\fBof\fR\fIM\fR\fB.deb\fR.
.SH "STATO D'USCITA"
.IX Header "STATO D'USCITA"
.IP "\fB0\fR" 4
.IX Item "0"
La suddivisione, unione o altra azione richiesta ha avuto successo. I comandi \fB\-\-info\fR vengono considerati conclusi con successo anche se i file non sono parti di un pacchetto binario.
.IP "\fB1\fR" 4
.IX Item "1"
Si verifica solo con \fB\-\-auto\fR e indica che il file \fIparte\fR non era una parte di un pacchetto binario.
.IP "\fB2\fR" 4
.IX Item "2"
Fatal or unrecoverable error due to invalid command-line usage, a file that looked like a package part file but was corrupted, or interactions with the system, such as accesses to the database, memory allocations, etc.
.SH "AMBIENTE"
.IX Header "AMBIENTE"
.IP "\fB\s-1DPKG_ROOT\s0\fR" 4
.IX Item "DPKG_ROOT"
If set and \fB\-\-root\fR option has not been specified, it will be used as the filesystem root directory (since dpkg 1.21.10).
.IP "\fB\s-1DPKG_ADMINDIR\s0\fR" 4
.IX Item "DPKG_ADMINDIR"
If set and the \fB\-\-admindir\fR or \fB\-\-root\fR options have not been specified, it will be used as the \fBdpkg\fR data directory (since dpkg 1.21.10).
.IP "\fB\s-1DPKG_DEBUG\s0\fR" 4
.IX Item "DPKG_DEBUG"
Sets the debug mask (since dpkg 1.21.10) from an octal value.  The currently accepted flags are described in the \fBdpkg \-\-debug\fR option, but not all these flags might have an effect on this program.
.IP "\fB\s-1DPKG_COLORS\s0\fR" 4
.IX Item "DPKG_COLORS"
Sets the color mode (since dpkg 1.18.5).  The currently accepted values are: \fBauto\fR (default), \fBalways\fR and \fBnever\fR.
.IP "\fB\s-1SOURCE_DATE_EPOCH\s0\fR" 4
.IX Item "SOURCE_DATE_EPOCH"
If set, it will be used as the timestamp (as seconds since the epoch) in the \fBdeb-split\fR(5)'s \fBar\fR(5) container.
.SH "FILE"
.IX Header "FILE"
.IP "\fI/var/lib/dpkg/parts\fR" 4
.IX Item "/var/lib/dpkg/parts"
La directory predefinita per la coda dei file delle parti in attesa di essere automaticamente riassemblate.
.Sp
I nomi dei file usati in questa directory sono nel formato interno di \fBdpkg-split\fR ed \(`e improbabile che siano utili per altri programmi; in ogni caso non si dovrebbe fare affidamento sul formato del nome file.
.SH "BUG"
.IX Header "BUG"
I dettagli completi sui pacchetti nella coda sono impossibili da ottenere a meno che l'utente non guardi da solo nella directory della coda.
.PP
Non esiste un modo semplice per testare se un file che potrebbe essere una parte di un pacchetto binario lo \(`e realmente.
.SH "VEDERE ANCHE"
.IX Header "VEDERE ANCHE"
\&\fBdeb\fR(5), \fBdeb-control\fR(5), \fBdpkg-deb\fR(1), \fBdpkg\fR(1).