Oscdimg Command-Line Options

  • Article

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

Note

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

Oscdimg Command-Line Options

The following command-line options are available for Oscimg.

oscdimg [options] SourceLocationTargetFile

Option Description

-a

Displays the allocation summary for files and directories.

-blocation

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 means not to use floppy disk emulation in the El Torito catalog. This option can only be used for single boot entry images and can not 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.

-llabelname

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 -o.

-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 can not be combined with any multi-boot entry switches.

-q

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

-tmm/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 initial64,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 shall be in ANSI.
  2. The order file shall end in a new line.
  3. The order file shall have one file per line.
  4. Each file shall be specified relative to the root of the image.
  5. Each file shall 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 shall be ordered as they would be if there was no 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.