| ## Rawrite32 NetBSD disk/USB stick image tool for Win32

You may use this tool for preparing floppy disks or ZIP media to boot NetBSD from. It takes a file called "a filesystem image" (usually with a ".fs" suffix) or a compressed variant thereof (usually with ".fs.gz" suffix) and writes it to a removeable medium. This is similar to formatting a disk with the "transfer system files" option checked.

This program has it's homepage at http://www.netbsd.org/~martin/rawrite32/, where you will also find it's full license terms, and source code. A short version of the license is reproduced below.

Details on howto invoke this utility and it's command line options are explained below.

| This is a typical screen while working with Rawrite32. Please click on the parts of the screen you would like documentation on. Please note that the main menu will be hidden in normal operation, you can make it visible by typing ALT or F10. The typical workflow is: Select a disk image Verify hash values Select target device Write image to device For the latter item, note that you can select between writing to physical devices mode (the default), and writing to partitions (which is useful for backup/restore purposes, but not in the context of creating NetBSD boot media). If you are using an ancient Win9x/Millennium version, you will only be able to write to floppy disks.

## Main Menu

The main menu (only visible after pressing F10 or ALT) contains no hidden gems - everything is available via other parts of the GUI, check especially the settings icon and the help icon.

## Settings Menu

Hash options shows a dialog to select hash values calculated when opening image files.

Sector skip shows a dialog to select the first sector written to the medium, or in other words: how many sectors to skip at the start.

Right in this menu you can select the target device mode:

- Writing to logical volumes (typically recognizable by the assigned "drive letters") allows writing to floppy disks or parts of disk devices that have been created by partitioning disks into slices.
- Writing to physical devices overwrites any partitioning information present on the device, so it is possible to write an image to a usb stick that creates two partitions, e.g. a FAT partition and a NetBSD ffs file system. To create bootable media, you will typically need to use this mode.

Note that ancient windows versions not based on Windows NT do not offer a generic access method for USB sticks, so you are restricted to logical volumes mode, and floppy disks as target drives.

## Help Menu

This menu contains references to this help, the official web site, and, most important, the "about" box.

## Hash Options

| Hash values are used to ensure the integrity of a downloaded file. Basically they are strong cryptographic check sums over the input file. If you compare the values calculated by Rawrite32 (and copied to the windows clipboard) with the values published by the publisher of the disk image you have downloaded, you should be able to spot any alterations (due to network problems or manual tampering on mirrors). There are several "approved" algorithms, and one (MD5) used for historical reasons but considered "not quite safe" nowadays. You need to select the hash algorithms you find published values for your image for - for the NetBSD case, the default selection will deliver all the values you might need. If the sum for a strong algorithm (like SHA512) matches, there is no need to compare all the weaker results too. The hash options, by default, will fit your computers abilities, i.e. use the minimal useful set on slower/single CPU machines, and calculate all available hashes on multi core machines, where additional hash values will not cause a noticeable slowdown.

## Select a file

Opens a file browser dialog to select a file system image file. This is the typical way to enter a filename into the "Filename of image" edit box.

## Filename of image

The filename of the image to be written to disk. Rawrite32 accepts filesystem image files (suffix ".fs") and compressed filesystem images (suffix ".fs.gz" or ".fs.bz2"). The utility doesn't verify the contents of the image (i.e. you can use this tool to write a word document on your boot disk if you like), but it displays the MD5 checksum of the file (and additionally of the decompressed contents, if the file is compressed). These values are displayed in the output area and copied to the clipboard. These values are published with every release or snapshot of NetBSD boot media, so you can compare them and verify you got the original image.

## Target

Select the removable media (or physical device) to write the image to. If you are using "logical volumes" mode, this combobox lists all available volumes; if using physical device mode, it lists all devices. Devices that carry the current windows installation system directory are not offered (i.e. you typically will not see the device with C:\ on it in this list).
Be very careful when selecting a target, this program is able to kill all the contents on the selected drive/device. It will delete all previous contents, so you better double check the selection.

## Sector skip

Normally left blank, use only when following exact instructions telling you to enter some value here!

Some install media preparation process may involve copying multiple images to a media or leaving the first part of the media alone for other reasons (e.g. because it contains a partition table). This can be accomplished by entering the number of (512 Byte sized) sectors to skip at the start of the device here when writing the second (or later) parts of the contents.

## Write to disk...

Starts the transfer to disk/USB device. This button is disabled unless you have selected a valid drive to transfer to (any removable will do) and a valid image to copy there. It will be disabled on illegal sector offset inputs.

If your intended target device is not listed here, check the target device mode in the settings menu. If you added the USB device after starting Rawrite32 it might not yet be listed - just quit and restart the program, after Windows tells you the device would be usable.

## Program messages

The program outputs messages describing state/progress here. You can not enter anything there, it is like a TV: just watch the show.

| Progress during decompression/writing to target device is separated into input and output parts. Depending on the decompression and device writing speed, these values might get seriously out of sync. Since only the input size is deterministically known upfront, the progressbar only shows consumed input.

| After output completed successfully, a (single, quick) hash value over all the output data will be displayed. This is more of a debugging feature for Rawrite32; whenever you have verified the input hash values, it would be impossible for somebody else to move things around or otherwise temper with your data. Note that the output hash is not a verification pass on the media, the values are calculated before passing the data to the device - it is not read again.

## Invocation and Command Line Options

Normally you invoke this program by double clicking on the EXE file in the windows explorer or on a link to it. You then use the "Select" button to open a browser dialog and select the file you would like to write to disk.

You can also select the file in the windows explorer and drag&drop it onto the program.

Another option is to invoke the program from the command line, passing the file to write as it's parameter.

## License

Copyright © 2000-2003,2010,2011 Martin Husemann <martin@NetBSD.org>.
Copyright © 2010 Izumi Tsutsui <tsutsui@NetBSD.org>.
Copyright © 2010 Quentin Garnier <cube@NetBSD.org>.
All rights reserved.

Usage of this program is free. Use it at your own risk. See the full license for details.

If you would like to redistribute this program in any form, please see the full license for details.