woeusb(1)

1
2
3
4
5
6woeusb(1)                     WoeUSB User Manual                     woeusb(1)
7
8
9

NAME

11       woeusb - Bootable Windows installation/PE USB storage creator
12
13

SYNOPSIS

15       woeusb [OPTIONS] --device|--partition source_media target_media
16
17

DESCRIPTION

19       woeusb  is  a  command-line utility that enables you to create your own
20       bootable Windows installation USB storage device from an existing  Win‐
21       dows Installation DVD or its ISO image.
22
23       It  mainly  extracts all files from source_media to target_media , then
24       installs GNU GRUB bootloader and a small configuration into it to  sup‐
25       port chainloading Windows BOOTMGR.
26
27       It  also  supports  UEFI bootstrap scheme, however in this case Windows
28       UEFI bootloader is used instead.
29

COMMAND-LINE OPTIONS

31   CREATION METHOD
32       --device / -d source_media target_device
33              Drop target_device ´s partition table(if there's any), create  a
34              new PC/Legacy/MBR partition table, create a FAT32/NTFS partition
35              spanning (almost) the entire disk, then setup  bootable  Windows
36              on it.
37
38              WARNING: ALL PREVIOUS DATA ON target_device WILL BE DROPPED!
39
40
41       --partition / -p source_media target_partition
42              Mount  target_partition  ´s file system, extracts all files from
43              source_media into it, then make it bootable.
44
45              WARNING: ALL FILES EXISTING ON target_partition  WITH  THE  SAME
46              FILENAME IN source_media WILL BE OVERWRITTEN!
47
48
49   MISCELLANEOUS
50       --help / -h
51              Print application help message
52
53       --version / -V
54              Print application version
55
56       --about / -ab
57              Print info about this application
58
59       --verbose / -v
60              Be more verbose
61
62       --debug
63              Enable script debugging
64
65       --no-color
66              Disable message coloring
67
68       --label / -l filesystem_label
69              Specify label for the newly created file system in --device cre‐
70              ation method
71
72              Note that the label is not verified for validity and may be  il‐
73              legal for the filesystem
74
75       --workaround-bios-boot-flag
76              Apply workaround for buggy BIOSes that doesn't consider a device
77              bootable if none of its partition's boot flag is toggled.
78
79       --debugging-internal-function-call   function_name    (function_parame‐
80       ters...)
81              Development option for developers to test certain function with‐
82              out running the entire build
83
84       --target-filesystem / --tgt-fs filesystem_name
85              Specify the filesystem to use as the target partition's filesys‐
86              tem.  Currently supported: FAT(default)/NTFS
87
88

EXAMPLES

90       We love examples!
91
92       Completely  DESTROY all previous data on a USB storage device, recreate
93       the partition table and the target partition, copy the  Windows  files,
94       and make it bootable
95       # woeusb --device win7_amd64.iso /dev/sdX
96       # woeusb --device /dev/sr0 /dev/sdX
97
98       Copy Windows files to an existing FAT partition of a USB storage device
99       and make it bootable
100       # woeusb --partition win7_amd64.iso /dev/sdX1
101       # woeusb --partition /dev/sr0 /dev/sdX1
102
103

EXIT STATUS

105       0 when success, 1 (and non-zero if there's any) when failure
106
107

BUGS

109       Refer to our  issue  tracker  ⟨https://github.com/WoeUSB/WoeUSB/issues⟩
110       for any known issues
111
112

AUTHORS

118       Colin GILLE / congelli501 <colingille@hotmail.com>
119       林博仁(Buo-ren, Lin) <Buo.Ren.Lin@gmail.com>
120
121
122
123WoeUSB                               5.1.2                           woeusb(1)