wimlib.net Git - wimlib/blob - doc/man1/wimsplit.1

   1 .TH WIMSPLIT "1" "January 2017" "wimlib 1.11.0" "User Commands"
   2 .SH NAME
   3 wimsplit \- Split a WIM archive into multiple parts
   4 .SH SYNOPSIS
   5 \fBwimsplit\fR \fIWIMFILE\fR \fISPLIT_WIM_PART_1\fR \fIPART_SIZE\fR [\fIOPTION...\fR]
   6 .SH DESCRIPTION
   7 \fBwimsplit\fR, or equivalently \fBwimlib-imagex split\fR, splits \fIWIMFILE\fR
   8 into parts with size at most \fIPART_SIZE\fR mebibytes (power-of-2 megabytes),
   9 with the first part having the name \fISPLIT_WIM_PART_1\fR and the other parts
  10 having names numbered in order of the parts.
  11 .PP
  12 \fBwimsplit\fR can split both non-pipable and pipable WIMs.
  13 .SH OPTIONS
  14 .TP 6
  15 \fB--check\fR
  16 Before splitting the WIM, verify its integrity if it contains extra integrity
  17 information.  Also include extra integrity information in each split WIM part,
  18 even if \fIWIMFILE\fR did not contain it.
  19 .SH EXAMPLES
  20 Splits the WIM 'windows.wim' into 'windows.swm', 'windows2.swm', 'windows3.swm',
  21 etc. where each part is at most 100 MiB:
  22 .RS
  23 .PP
  24 wimsplit windows.wim windows.swm 100
  25 .RE
  26 .SH LIMITATIONS
  27 It is possible for the size of the parts to exceed the \fIPART_SIZE\fR given.
  28 This is impossible to avoid because the WIM file format provides no way to
  29 divide a single file resource among multiple split WIM parts.  So if you, for
  30 example, have a file inside the WIM that is 100 MiB compressed, then the split
  31 WIM will have at least one part that is 100 MiB in size to contain that file.
  32 .SH SEE ALSO
  33 .BR wimlib-imagex (1)
  34 .BR wimjoin (1)