woeusb(1)

1woeusb(1)                     WoeUSB User Manual                     woeusb(1)
2
3
4

NAME

6       woeusb - Bootable Windows installation/PE USB storage creator
7
8

SYNOPSIS

10       woeusb [OPTIONS] --device|--partition source_media target_media
11
12

DESCRIPTION

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

COMMAND-LINE OPTIONS

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

EXAMPLES

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

EXIT STATUS

100       0 when success, 1 (and non-zero if there's any) when failure
101
102

BUGS

104       Refer to our  issue  tracker  ⟨https://github.com/slacka/WoeUSB/issues⟩
105       for any known issues
106
107

AUTHORS

113       Colin GILLE / congelli501 <colingille@hotmail.com>
114       林博仁 <Buo.Ren.Lin@gmail.com>
115
116
117
118WoeUSB                               3.3.1                           woeusb(1)