Oscdimg is a command-line tool for creating an image (.iso) file of a customized 32-bit or 64-bit version of Windows® PE. You can then burn the .iso file to a CD-ROM or DVD-ROM. Oscdimg supports ISO 9660, Joliet, and Universal Disk Format (UDF) file systems.

Note:
  • To create a bootable CD-ROM, you must use CD-recording software that unpacks the .iso file and burns it to a CD-ROM. Merely copying the .iso file to the CD-ROM will not work.

  • The Oscdimg tool is not supported on an Itanium-based computer running Windows Server 2003.

Oscdimg Command-Line Options

The following command-line options are available for Oscdimg.

oscdimg [options] SourceLocation TargetFile

Option Description

-a

Displays the allocation summary for files and directories.

-b location

Specifies the location of the El Torito boot sector file. Do not use any spaces, for example, -bC:\Directory\Etfsboot.com

-c

Specifies to use ANSI file names instead of OEM file names.

-d

Does not force lowercase file names to uppercase.

-e

This option disables floppy disk emulation in the El Torito catalog. This option can only be used for single boot entry images and cannot be combined with any multi-boot entry switches.

-g

Uses the Universal Coordinated Time (UCT) for all files rather than the local time.

-h

Includes hidden files and directories.

-j1

Encodes Joliet Unicode file names and generates DOS-compatible 8.3 file names in the ISO 9660 namespace. These file names can be read by either Joliet systems or conventional ISO 9660 systems, but Oscdimg may change some of the file names in the ISO 9660 name space to comply with DOS 8.3 and/or ISO 9660 naming restrictions.

When using the -j1, -j2, or -js options, the -d, -n, and -nt options do not apply and cannot be used.

-j2

Encodes Joliet Unicode file names without standard ISO 9660 names. (Requires a Joliet operating system to read files from the CD-ROM.)

When using the -j1, -j2, or -js options, the -d, -n, and -nt options do not apply and cannot be used.

-js

Overrides the default text file used with the -j2 option, for example, -jsc:\Readme.txt

When using the -j1, -j2, or -js options, the -d, -n, and -nt options do not apply and cannot be used.

-k

Creates an image even if it fails to open some of the source files.

-l labelname

Specifies the volume label. Do not use spaces between the l and labelname.

For example, -lMYLABEL

-m

Ignores the maximum size limit of an image.

-maxsize: limit

Overrides the default maximum size of an image. The default value is a 74-minute CD, unless UDF is used, in which case, the default is that there is no maximum size. The limit value is specified in megabytes (MB). For example, -maxsize:4096 limits the image to 4096 MB.

The -m option cannot be used with this option.

-n

Enables long file names.

-nt

Enables long file names that are compatible with Windows NT 3.51.

-o

Optimizes storage by encoding duplicate files only once using a MD5 hashing algorithm to compare files.

-oc

Optimizes storage by encoding duplicate files only once using a binary comparison of each file. This option is slower than the -o option.

-oi

Optimizes storage by encoding duplicate files only once. When comparing files, ignores Diamond compression timestamps.

-os

Optimizes storage by encoding duplicate files only once. Shows duplicate files when creating the image.

-ois

Optimizes storage by encoding duplicate files only once. When comparing files, ignores Diamond compression timestamps. Shows duplicate files when creating the image.

-p

Specifies the value to use for the Platform ID in the El Torito catalog. The default is 0x00 to represent the x86 platform. This option can only be used for single-boot entry-images and cannot be combined with any multi-boot entry switches.

-q

Scans the source files only; it does not create an image.

-t mm/dd/yyyy,hh:mm:ss

Specifies the timestamp for all files and directories. Do not use any spaces. Use the United States of America date format and a 24-hour clock. You can use any delimiter between the items.

For example,

-t12/31/2000,15:01:00

-u1

Produces an image that has both the UDF file system and the ISO 9660 file system. The ISO 9660 file system will be written with DOS-compatible 8.3 file names. The UDF file system will be written with Unicode file names. This option cannot be combined with the -n, -nt, or -d options.

-u2

Produces an image that has only the UDF file system on it. Any system not capable of reading UDF will only see a default text file alerting the user that this image is only available on computers that support UDF. This option cannot be combined with the -n, -nt, or -d options.

-ur

Overrides the default text file used with the -u2 option. Example: -urc:\Readme.txt

This option cannot be combined with the -n, -nt, or -d options.

-us

Creates sparse file when available. This can only be used with the -u2 option. This option cannot be combined with the -n, -nt, or -d options.

-ue

Creates embedded files. This can only be used with the -u2 option. This option cannot be combined with the -n, -nt, or -d options.

-uf

Embeds UDF file identifier entries. This can only be used with the -u2 option. This option cannot be combined with the -n, -nt, or -d options.

-uv

Specifies UDF Video Zone compatibility during DVD Video/Audio disk creation. This means UDF 1.02 and ISO 9660 are written to the disk. Also, all files in the VIDEO_TS, AUDIO_TS, and JACKET_P directories are written first. These directories take precedence over all other ordering rules used for this image. This option cannot be combined with the -n, -nt, -d, -j1, -j2, -js, -u1, -u2, -ur, -us, -ue, -uf, or -yl options.

-ut

Truncates the ISO 9660 portion of the image during DVD video/audio disk creation. When this option is used, only the VIDEO_TS, AUDIO_TS, and JACKET_P directories are visible from the ISO 9660 file system. This option cannot be combined with the -n, -nt, -d, -j1, -j2, -js, -u1, -u2, -ur, -us, -ue, -uf, or -yl options.

-w1

Reports all file names or depths that are not ISO-compliant or Joliet-compliant.

-w2

Reports all file names that are not DOS-compliant.

-w3

Reports all zero-length files.

-w4

Reports each file name that is copied to the image.

-x

Computes and encodes the AutoCRC value in the image.

-yd

Suppresses warnings for non-identical files with the same initial 64,000 bytes.

-yl

Specifies long allocation descriptors instead of short allocation descriptors. This option cannot be combined with the -n, -nt, or -d options.

-y5

Specifies file layout on disk. This option writes all files in an i386 directory first and in reverse sort order.

-y6

Specifies that directory records be exactly aligned at the end of sectors.

-yo

Specifies file layout on disk. This option specifies a text file that has a layout for the files to be placed in the image. The rules for this file are listed below.

  1. The order file must be in ANSI.

  2. The order file must end in a new line.

  3. The order file must have one file per line.

  4. Each file must be specified relative to the root of the image.

  5. Each file must be specified as a long file name. No short names are allowed.

  6. Each file path cannot be longer than MAX_PATH, including volume name.

Note that not all files must be listed in the order file. Any files that are not listed in this file will be ordered as they would be by default in the absence of an ordering file.

Important:

The -yo option takes precedence over the -y5 option.

-yw

Opens source files with write sharing.

SourceLocation

Required. Specifies the location of the files that you intend to build into an .iso image.

TargetFile

Specifies the name of the .iso image file.

Creating DVD images

For images larger than 4.5 GB, you must create a boot order file (Bootorder.txt) to ensure boot files are located at the beginning of the image. For example,

oscdimg -m -n -yoC:\temp\bootorder.txt -bC:\winpe_x86\etfsboot.com

Where bootorder.txt contains the following list of files.

boot\bcd
boot\boot.sdi
boot\bootfix.bin
boot\bootsect.exe
boot\etfsboot.com
boot\memtest.efi
boot\memtest.exe
boot\en-us\bootsect.exe.mui
boot\fonts\chs_boot.ttf
boot\fonts\cht_boot.ttf
boot\fonts\jpn_boot.ttf
boot\fonts\kor_boot.ttf
boot\fonts\wgl4_boot.ttf
sources\boot.wim

See Also

Command-Line Tools Technical Reference