      DFSee version 9.09 24-05-2008  (c) 1994-2008: Jan van Wijk
 =========================[ www.dfsee.com ]==========================

_______________________________________________________________________________

C O N T E N T S:
_______________________________________________________________________________

  Command reference = overview of FDISK specific commands
  Detailed description = description of every command


  Note: All generic commands can be found in DFSCMDS.TXT, for example:

        PART, ALLOC, CHECK, CLONE, IMAGE, RESIZE, RECOVER, SAVETO, SCAN, WIPE

_______________________________________________________________________________

C O M M A N D   R E F E R E N C E:
_______________________________________________________________________________

FDISK specific commands

Active filesystem : FDISK / IBM-BMGR,  specific commands are:

 APMAP                      [-v] = Display Apple-Part-MAP in first disk track
 BMFIX     [disk               ] = Fix IBM BMGR bootsector W2K & CHS issues
 BMP       [disk  | -d:disknr  ] = Show BMGR primary names sector for a disk
 CLEANUP   [disk|.|*           ] = Cleanup partitiontables, fix several errors
 CR        [parameters][options] = Create a new partition, use 'CR' for usage
 DELETE    [pid] [disk][options] = Delete one or ALL partitions from disk(s)
 DISK      [disk]           [-r] = Select disk, show MBR; <Enter> = next EBR
 DFSIBMGR   disk [imagefilename] = Create new IBM BootManager image for 'create'
 FAT2OS     pid [disk [boot-OS]] = Set FAT-BR boot code to OS2|NT|IBMDOS|MSDOS
 FIXCHS     disk|.|*  [-c:0|1|2] = Fix CHS values to match LBA/current geometry
 FIXEXT     disk|.|* [to [from]] = Fix ext-partition types to standard value
 GENPART    disk|.|* [fn] [opts] = Generate DFSee partitioning script for disk(s)
 LVM       [pid]       [options] = Update name, letter and BM-menu for partition
 LVMSHOW   [pid |  *]            = Show related LVM-info for 1 or all partitions
 LVMREDO   disk|.|*         [-C] = Refresh LVM info sectors (DLAT) for disk(s)
 NEWMBR    [disk|.|*]       [-c] = Refresh MBR boot code, [-clean] = delete all
 NTSIGN    [disk    [signature]] = Set NT-signature in MBR, hex signature value
 MOUNT  [opt] Fname | size [H S] = Mount a partionable medium (virtual / image)
 PLIST      p|f|e|m|b|w|l [d[r]] = List: part|free|ebr|mbr|boot|walk|lvm [opt]
 PCLEAR     disk [P][Lvm[S]][Br] = Clear info in P-tables, LVM and/or Boot record
 PSAVE      disk|.|*  Fn [descr] = Save Partition table and LVM info in a file
 PRESTORE   disk|.|*  Fn [types] = Write info from file into P-tables and LVM
 PT        [pid|drive|*]         = Display partitioning sectors for partition(s)
 SETACCESS  pid [hide|vis|multi] = Make partition 'pid' accessible or hidden
 SETBOOT           opt[:options] = BootManager setup and reboot => 'setboot ?'
 SETLET     pid  letter | - [-n] = Set driveletter for DFSee; [-n] = no sync (NT)
 SETNAME    pid        [BM-name] = Set or reset (non-LVM) BMGR name for partition
 SETTYPE    pid  disk new  [old] = Change partition type from old to new value
 STARTABLE  pid  [multi | clear] = Make partition 'pid' startable (ACTIVE)
 TYPE        [type | first last] = Show system type description (for 00..ff)
 UNMOUNT    disk | * | -all      = Unmount removable medium (virtual / image)
 VCU        disk | . | * -d[:nr] = Clear existing LVM-info, create new defaults
 VSTATUS                         = Show R/W and usage status of virtual disks
 WALK      [disk | .]       [-r] = Select disk, show the MBR, walk EBR chain


 For an up-to-date list of commands, use the '?' command

 FDISK specific sector types (see ??? command)

  'A' = MAC DDM, drive description      'a' = MAC DPM, partition map, Apple
  'l' = LVM disk and volume info        's' = LVM signature sector
  'd' = LVM DriveLink sector            'D' = LVM DriveLink table
  'f' = LVM BadBlockRelocation sector   'F' = LVM BadBlockRelocation table
  'p' = VRAID phys device               'v' = VRAID devicetype1
  'V' = VRAID devicetype2               'X' = Unidentified data

_______________________________________________________________________________

D E T A I L E D   D E S C R I P T I O N:
_______________________________________________________________________________

 APMAP                      [-v] = Display Apple-Part-MAP in first disk track

 Purpose:       Display any Apple Partition MAP records present in first track

 Options:               -v       = Verbose, multiple lines per partitions found

 Output:        Prompting, progress and confirmation information.

 Remarks:       This displays the CLASSICAL Apple partition map as used by
                older MAC's or MAC compatible removable media as well as some
                other hardware devices like the 'Tivo' media player.
_______________________________________________________________________________

 BMFIX     [disk               ] = Fix IBM BMGR bootsector W2K & CHS issues

 Purpose:       Make IBM BootManager sectors survive a Win-2000 CHKDSK and fix
                inconsistent boot/datasector CHS values to match BMGR location

 Parameters:    disk    optional   Nr of the disk containing IBM BootManager

 Output:        Prompting, progress and confirmation information.

 Remarks:       The method used is based on a C't article and uses the
                FAT bootsector field 'reserved sectors to 1st FAT' to
                protect the BMGR data area

                Some additional changes were inspired by Daniela Engert and
                avoid the nasty CHKDSK screen while booting W2K (ver 3.36)

                The CHS values that are embedded in the BMGR datasector are
                checked and corrected when needed. These will rarely cause
                problems but CAN trigger a bug in the IBM setboot program
                for incorrect values below cylinder 1024. This may lead to
                overwriting one sector of data at that (incorrect) location.
                The DFSee builtin setboot command, or external SETBOOT program
                (in eCS 1.2 and up) is not affected by this bug at all ...


                Another (not DFSee related) thing you might do to avoid
                any conflicts is to hide your HPFS volumes from WIN2000.
                If you don't you will sometimes be prompted with the
                frightening: "Volume is not formatted, format it now?"
                If you reply with "YES" you just lost your HPFS partition!

                To hide a volume from normal WIN2000 programs like Explorer:

                Start
                  Settings
                    Control Panel
                      Administration Tools
                        Computer Management
                          Disk Management

                            Now select the HPFS partition from the list,
                            based on drive-letter and/or partition size.
                            Use right mouse button to get the context menu

                              Change Driveletter and paths ...

                              Now click the [remove]  button

                This will only remove the DRIVE-LETTER association for that
                partition in WIN2000, the partition itself is not touched!

                The same can be done in Windows XP (and probably Vista :-)
                although the exact procedure may differ slightly ...
_______________________________________________________________________________

 BMP       [disk  | -d:disknr  ] = Show BMGR primary names sector for a disk

 Purpose:       Show the IBM BootManager sector that has BM-names for primaries

 Parameters:    disk     optional   Disk number with BMGR to show names for

 Options:       -d[:disknr]         Disk number with BMGR to show names for

 Output:        Hexdump display of first part of that sector (if present)

 Remarks:       This sector is an array of 4 lines for each physical disk,
                one for each possible primary partition.
                Each line has an active flag-byte, head+sector/cylinder,another
                flag which is set when on the BM-menu, and the name string

                When using an LVM-enabled BootManager, the startable
                primaries are represented here with a "--> LVM" string
_______________________________________________________________________________

 CLEANUP    [disk]               = Cleanup partitiontables, fix several errors

 Purpose:       Clean up partitiontable flag values, making sure there is
                just ONE ACTIVE partition, clear non-standard flags and
                fix minor inconsistencies in partition chain, like removal
                of 'empty' extended containers and recalculation of the
                total size of each extended-container.

 Parameters:    disk    optional   Disk to operate on, default is all disks

 Options:       -c:[0|1|2|?] : CHS style: 1=PQMagic, 2=MS, default 0=IBM/DFSee

 Output:        Progress information and confirmation messages

 Remarks:       Inconsistencies can be caused by several operations, using
                DFSee, other FDISK versions, tools like Linux GRUB or
                Partition-Magic. Resizing and deleting with PQMagic can
                cause 'empty' extended containers.
_______________________________________________________________________________

 CR        [parameters][options] = Create a new partition, use 'CR' for usage

 You can use positional parameters and/or position independent options.
 For a detailed description of all the positional parameters and the
 position independent options see further below, short description:

          parameters   : pri|log  [type  [size  [loc  [pos  [BMGR-name]]]]]

         -p or -l      : Create a Primary or Logical partition. (mandatory)
         -t:numeric   : System Type, numeric, default DECIMAL  (mandatory)
         -t:'symbol'  : System Type, as a symbolic-name        (mandatory)
         -s:size       : Size, rounded UP to next cyl boundary (mcs-number)
         -d:disk-nr   : Location, use first fitting area on specified Disk
         -f:id        : Location, as Freespace id (1st column from 'part')
         -a:abs-pos   : Absolute position from start of disk  (mcs-number)
         -r:rel-pos   : Relative pos from start of freespace  (mcs-number)
         -e:end-pos   : Relative pos from end   of freespace  (mcs-number)
         -i:i13-pos   : Relative pos before the Int-13 limit  (mcs-number)
         -x:e13-pos   : Relative pos after the Int-13 limit   (mcs-number)
         -b:BMGR-name  : Partition name for (IBM, non-LVM) BootManager menu
         -c:[0|1|2|?]  : CHS dummy style: 1=PQMagic, 2=MS, default 0=IBM/DFSee
         -o            : Open the new partition after creation
         -A:pid|letter : Create AS partition; using same type and size
         -C            : Clear bootsector with 0xF6 pattern (FDISK behaviour)
         -F            : Set bootable status-flag in partition table (active)
         -G:n          : GAP value between table and bootsect, 1 .. tracksize
         -I[:image]    : Imagefile to be written to new partition
         -L            : Automatic 'lvm -V' on new partition
         -L:'lvm opts' : Automatic 'lvm' using specified options
         -M            : Allow multiple visible primaries (no automatic HIDE)
         -S:0|1|2|3    : prefered partition-table entry (Slot), default 0


       The mcs-number format is [0x]nnnn[,g|m|k|c|s] a HEX or decimal value,
       in GiB, MiB, KIb, Cylinders or Sectors. Default is decimal MiB.


       You can mix the old and new style syntax, as long as the 'old' type
       parameters are in the required fixed position as specified above
       and the 'pri|log' and 'type' are specified somehow.

       Examples: cr log hpfs 200  3  *  OS2MAINT
                 cr log hpfs 200  -d:3  -b:OS2MAINT
                 cr log hpfs -s:200  -d:3  -b:OS2MAINT
                 cr log -t:hpfs -s:200  -d:3  -b:OS2MAINT
                 cr -log  -t:hpfs  -s:200  -d:3  -b:OS2MAINT
                 cr -d:3 -b:OS2MAINT -t:hpfs -s:200 -logical
                 cr -disk:3 -bm:OS2MAINT -type:hpfs  -size:200  -logical

                 These are all variations of the same CReate command ...


 Purpose:       Create one new partition in an area that is now freespace

 Parameters     pri|log mandatory  Primary/Logical identifier;
 (old style)
                                   log  | l   Logical partition

                                   pri  | p   Primary partition


                type    mandatory  System-type for new partition;

                                   number     Hexadecimal value 0..ff
                                              or 0x.. or decimal 0t..

                                   symbolic   A name from the predefined
                                              set of partition types.
                                              (see SETTYPE for a list)


                size    optional   Desired size for the partition;

                                   *          Use maximum size for the
                                              selected freespace-area

                          number[[,d|x]m|c|s] Specific value, decimal or hex.
                                              Megabytes, Cylinders or Sectors.
                                              Default: decimal Megabytes


                loc     optional   Location to place new partition;

                                   *          Use first 'matching' area

                                   @fsp-id    Specific freespace area

                                   disk       Use first matching area on
                                              the specified disk


                pos     optional   Position in loc-area;

                                   *          Default position (at start)

               [+|-|@|{|}]number[[,d|x]m|c|s] Specific value, decimal or hex.
                                              Megabytes, Cylinders or Sectors.
                                              Default: decimal Megabytes
                                              Prefix modifiers are:
                                   +          Relative to start of area
                                   -          Relative to end of area
                                   @          Absolute from start of disk
                                   {          Relative, before 1024-cyl limit
                                   }          Relative, after  1024-cyl limit

                                              Note: The corresponding value
                                                    with the prefix can be 0
                                                    or empty

                BMGR-name optional Add to the IBM BootManager menu using this name


 Options:       -p         : Create a Primary partition
 (new style)    -l         : Create a Logical partition

                -t:type    : System Type, numeric or symbolic-name  (mandatory)
                             When numeric, the value is DECIMAL by default,
                             Hexadecimal can be specified using the '0x' prefix

                             Some symbolic names + HEX value and description:

                             FAT   = 01/04/06/0b/0c    Automatic FAT type
                             BMGR  = 0a                IBM BootManager
                             FAT32 = 0b/0c             Automatic 32-bit FAT
                             JFS   = 35                Journalled FS (LVM)
                             HPFS  = 07                OS/2 native filesystem
                             NTFS  = 07                Windows-NT>XP filesystem
                             SWAP  = 82                Linux SWAP partition
                             LINUX = 83                Linux native filesystem
                                                       (EXT2, Reiser etc)

                             Note: The automatic FAT types will use the required
                                   value based on partition size and position.

                             Example formats, all of the following are equal:

                             -t:ext2          symbolic name (case insensitive)
                             -t:'83'          hex value, as a string
                             -t:83h           hex value, with the 'h' postfix
                             -t:0x83          hex value, with the '0x' prefix
                             -t:131           decimal value, numeric format

                             Note:

                             -t:83            is decimal 83 ==> type 0x53 !!!

                -s:size    : Size, will be rounded UP to next cylinder boundary
                                   except when specified in sectors

                             Examples:

                             -s:800           size of 800 MiB, rounded UP
                             -s:30,c          size of 30 cylinders, rounded UP
                             -s:0x3fc0,s      size of exactly 0x3fc0 sectors

                -f:id      : Location, as Freespace id (1st column from 'part')
                -d:disk-nr : Location, use first fitting area on specified Disk
                -d or -d:0 : Location, currently open disk.   (this is default)
                -d-        : Use first fitting area on ANY disk.

                -a:abs-pos : Absolute position from start of disk  (mcs-number)
                -r:rel-pos : Relative position from start of area  (mcs-number)
                -e:end-pos : Relative pos from end of the disk     (mcs-number)
                -i:i13-pos : Relative pos before the Int-13 limit  (mcs-number)
                -x:e13-pos : Relative pos after the Int-13 limit   (mcs-number)

                -b:BM-name : Partition name for (IBM, non-LVM) BootManager menu

                -o         : Open the new partition after creation

                -A:pid|let   Create AS partition; using same type and size.
                             This "CREATE AS" will use the specified partition
                             primary/logical, type and size as a default.
                             Other options can be added, and overrule any
                             value set by the -A option.

                    Example: "CR -A:2 -t:fat32" will create a partition just
                             like the current 02 but with type FAT32.

                -C           Clear bootsector with 0xF6 pattern (like FDISK)
                             In combination with the -L option, this will also
                             clear the LVM signature sector (BBR) to 0xF6.

                -F         : Set bootable flag in partition table (active)

                -G:n'      : GAP between the EBR and bootsector for a LOGICAL.
                             A non-standard distance from partition-table to
                             bootsector is sometimes seen on Linux (-G:1).
                             Sector value, default is the tracksize (often 63)

                -I-        : Do NOT install any image (like DFSIBMGR.IMG) here.
                -I[:image] : Imagefile to be written to new partition, this can
                             be a RAW (.IMG) or compressed (.IMZ) image as used
                             with the IMAGE and RESTORE commands. It is intended
                             to initialize the new partition with existing data.
                             When no name is specified, you will be prompted.

                -I13X        Require an I13X capable MBR (from IBM or DFSee) to
                             use bootmanager with partitions beyond cyl 1024.

                -L           Automatic 'lvm -V' on new partition
                -L:'lvmopts' Automatic 'lvm' using specified options
                             In both cases LVM-information will be added
                             for the new partition, either interactively or
                             with defaults, or with the specified values.
                             The 'lvmopts' are simply options that are valid
                             for the LVM command, but combined in one string
                             with either double or single quotes.

                -M         : Allow multiple visible primaries (no auto HIDE)

                -S:0|1|2|3 : prefered partition-table entry (Slot), default 0
                             Used to exactly recreate a given layout, avoiding
                             changes in partition numbering (BOOT.INI etc)


 Output:        Progress information and confirmation messages

 Remarks:       When creating a type 0x0a = IBM BootManager partition, and
                an imagefile DFSIBMGR.IMG exists in the current directory,
                DFSee will prompt you to write this image to the new partition.
                In batch mode you can PREVENT an existing DFSIBMGR.IMG image
                to be installed by using the '-I-' option.
                A DFSIBMGR.IMG image can be created from an existing
                installation using the DFSIBMGR command.
                By default, the explicit 'I13X' check will be REMOVED from the
                bootsector code for the bootmanager, unless you specify -I13X-
_______________________________________________________________________________

 DELETE    [pid] [disk][options] = Delete one or ALL partitions from disk(s)

 Purpose:       Delete one or ALL partitions.

 Parameters     pid   : Partition id for 1 partition or '*' for all partitions
                pid,r : Relative partition ID on specified or current disk
                disk  : Physical disk number for 1 disk or '*' for all disks
                        Used for extra verification only

 Options:       -c-     No full clear, just reset system-type to 0x00
                -d      Partition to delete must be on current disk
                -d:[nr] Partition to delete must be on specified disk
                -p:x    Partition ID (PID) to delete (same as 'pid' parameter)
                -p:x,r  Relative partition ID on specified or current disk
                -L-     Do NOT delete related DLAT LVM info for a primary,
                        as this allows recreation in same place (resizing).

 Output:        Progress information and confirmation messages

 Remarks:       The partition will by default be deleted by clearing ALL 16
                bytes that make up the entry to ZEROES. Using the '-c-' option
                wil just set the system-type to hex '00'. This is the minimum
                required change and may allow for relatively easy rollback.
                Note that some programs, like the OS/2 LVM.EXE have problems
                with partially deleted partitions, and claim the tables
                are invalid if the 'deleted' partition overlaps another.

                By default, related IBM BootManager (pre-LVM) and DLAT LVM
                information is automatically removed to avoid inconsistencies,
                unless the -L- option is used to keep that info present.
_______________________________________________________________________________

 DFSIBMGR   disk          [name] = Create new IBM BootManager image for 'create'

 Purpose:       Create a DFSIBMGR.IMG image-file from the IBM BootManager
                installed on the specified disk, to be used later on 'create'
                commands when creating new IBM BootManager partitions.

 Parameters:    disk    mandatory  Disk to get the IBM BootManager image from
                name    optional   Name for the image (default DFSIBMGR.IMG)

 Output:        Progress information

 Remarks:       The 'create' command will automatically search for an image
                with this name when a type 0x0a = BMGR partition is created.
_______________________________________________________________________________

 FAT2OS     pid [disk [boot-OS]] = Set FAT-BR boot code to OS2|NT|IBMDOS|MSDOS

 Purpose:       Replace boot code by OS/2, NT, IBMdos or MSdos boot code for FAT

 Parameters     pid     : Partition id for 1 partition or '*' for all
                pid,r     Relative PID, on current or specified disk
                disk    : Physical disk number for 1 disk or '*' for all
                boot-OS : Specifier for boot code, taken from operating system:

                          OS2    - OS/2   version 4 (Warp, Merlin)
                          NT     - Win-NT version 4
                          IBMDOS - IBM DOS 7.0
                          PCDOS  - IBM DOS 7.0
                          MSDOS  - MS  DOS 6.22

 Options:       -d[:nr]      : Use current or [specified] disk for relative PID

 Output:        Progress information and confirmation messages

 Remarks:    a: The command only replaces the boot code part of the FAT
                bootsector. Other stuff, like the boot parameter block (BPB)
                is kept intact to preserve geometry and format information

             b: This command is intended to prepare a partition for booting
                the specified OS (FAT only), from a pure DOS environment.

                Step 1) Partition using DFSee FDISK (make at least 1 FAT)
                Step 2) Reboot, to make DOS assign a drive-letter
                Step 3) Format the FAT partition using standard DOS FORMAT
                Step 4) Use DFSEE FAT2OS command to make it correctly bootable
                Step 5) Xcopy a saved set of specific operating system files
                        to the partition, including the system-files like
                        OS2BOOT, OS2LDR, NTLDR, IBMBIO/IBMDOS, IO.SYS/MSDOS.SYS
                        etc., depending upon the Operating System.
                Step 6) Boot that partition (directly or through a BMGR)
_______________________________________________________________________________

 FIXCHS     disk  [-c[:0|1|2|?]] = Fix CHS values to match LBA/current geometry

 Purpose:       Change all nonstandard values for the CHS fields in partition
                tables to valid ones to avoid warnings or failures working
                with other disktools (FDISK, LVM, Partition-Magic etc)

 Parameters:    disk    mandatory  Disknr or '.' for current, '*' for all disks

 Options:       -c:[0|1|2|?] : CHS style: 1=PQMagic, 2=MS, default 0=IBM/DFSee
             or -c:IBM         To override the global style being used, and
             or -c:PQ          force ALL CHS value to use this specific style.
             or -c:MS          useful to avoid "corruption" messages/errors
                               by tools like Partition-Magic or LVM ...
                -c:?           Will force the CHS-style selection dialog to
                               be presented if when 'make default' was used

 Output:        Progress information and confirmation messages

 Remarks:       Nonstandard values for the CHS fields sometimes cause
                problems in tools like LVM, it refuses to update anything
                because the "partition table might be corrupt" ...

                There are two cases: for cylinders below 1024 the CHS values
                must match the calculated linear values (LBA) exactly, and
                above cylinder 1024 they should be acceptable 'dummy' values.
                For the dummy values, a few styles are supported, the default
                is the one normally created by DFSee and by OS/2 FDISK or LVM
                but you can also select the PowerQuest style to make sure
                Partition-Magic or Drive-Image are satisfied.

                Note that the calculated LBA values depend on the logical
                geometry being used, so check if that geometry is the one
                you want (or need) to use.

                Fixing this will get rid of all the DFSee warnings related
                to CHS problems (as displayed with 'part -w:chs')
                However, cylinder alignment warnings will stay because the
                partitions are not moved or resized. This is often less of
                a problem than CHS mismatches.
_______________________________________________________________________________

 FIXEXT  [disk | * [to  [from]]] [-a] [-e] = Fix extended-container types

 Purpose:       Change between the (windows specific) value 0x0f and the
                standard 0x05 value for the extended container(s).
                This will allow older operating systems like DOS and OS/2
                to access the logical volumes inside the extended-partition.

 Parameters:    disk    optional   Disk number or '*', default all disks = '*'

                to      optional   New system-type for EBR, default is 0x05

                from    optional   Existing system-type, default is 0x0f

                Options:     -a    Change ALL containers, not justvthe first
                             -e    Force setting type other than 0x05 or 0x0f

 Output:        Progress information and confirmation messages

 Remarks:       The nonstandard type 0x0f was introduced by Win9x combined
                with the FAT32 filesystem. These allow partitions larger
                then 2GiB and spanning the 8GiB BIOS limit (1024 cylinders).
                Using the 0x0f type prevents older operating systems from
                accessing, and possibly damaging, the new partitions.

                When all FAT16 partition are below cylinder 1024, there
                seems to be NO VALID REASON to use this type, and it can
                be safely changed back to 0x05 to allow access by DOS,
                OS/2 and others.

                To change the type of a regular primary or logical partition
                use the 'settype' command, or force it being changed to a
                regular partition type by using the '-e' option.
                Note that changing an extended container to a  regular primary
                or logical partition with '-e' will cause problems if it
                results in an illegal combination of defined partitions.
_______________________________________________________________________________

 GENPART    disk|.|* [fn] [opts] = Generate DFSee partitioning script for disk(s)

 Purpose:       Generate a DFSee script (.DFS) that will (re)create partitions
                as they are now, on the same or a different disk

 Parameters:    disk    mandatory  Disk number or '*', default all disks = '*'

                fn      optional   Base filename for the script to generate

                descr   optional   Description string that will be added to the
                                   confirmation message when the script is RUN

 Options:       -s        : Use SECTOR based size and location values instead
                            of cylinder and megabyte values (exact copy)

                -f-       : Do NOT include freespace areas, by allowing
                            automatic placement of the new partitions

                -!        : Force interactive dialog to specify/confirm options


 Output:        One line confirming each script being generated, and when
                applicable, the interactive dialog to specify options

 Remarks:       none
_______________________________________________________________________________

 LVM       [pid | *]   [options] = Update name, letter and BM-menu for partition

 Purpose:       Set/show LVM related values for a partition (update or display)

 Parameters     pid     optional   Partition id for partition to update or '*'
                pid,r              Relative PID, on current or specified disk

 Options:       -v:volume    : Set volume name (= IBM BootManager name if on menu)
                -v:"" or -v- : Remove volume name. This deletes the volume for LVM
                -p:part      : Set partition name for this partition
                -p:"" or -p- : Remove partition name. LVM will use a default.
                -l:letter    : Set preferred driveletter for the volume
                -l:"" or -l- : Remove driveletter for the volume (hide)
                -m    or -m- : Set volume on the IBM BootManager menu, or remove it
                -i    or -i- : Set installable status for volume,  or remove it
                -s           : Force synchronization of start/size with P-tables
                -lvmsnp:snp  : Force specific LVM partition Serial number
                -lvmsnv:snv  : Force specific LVM volume Serial number
                -lvmsnd:snd  : Force specific LVM Drive Serial number
                -lvmsnb:snb  : Force specific LVM Boot Drive Serial number
                -synclvm     : Force  sync LVM Engine on driveletter change (OS2)
                -synclvm-    : Do NOT sync LVM Engine on driveletter change (OS2)

                -P-          : Do not prompt for values with a dialog window

                -D           : Force default or recovered values to be used, by
                               deleting existing values before assigning new ones.
                               LVM-info can be recovered from the LVM-signature.
                -C           : Clear the LVM-signature sector (BBR information)
                               required to change LVM (JFS) to a Compatibility
                -r-          : Do NOT use existing LVM-signature data in recovery
                -V           : Automatically assign a volume name when new LVM
                               info is created. This will make the partition a
                               volume too, but without a drive-letter.
                -R           : Read-only, just show values (as used from LVMSHOW)

                -c           : Update CRCs for LVM sectors on selected disk(s)
                -G           : Update LVM disk-geometry to match the DFSee L-Geo
                -n[:name]    : With no PID or PID specified as '*' (disk update)
                               set disk name for selected disk(s), optional prompt
                               When changing the name, the internal LVM DiskID
                               will be synchronized for all partitions too.
                -n[:name]    : With an explicit PID specified (partition update)
                               set default disk name, if no LVM diskname present

                -d:nr        : disk number, restrict updates to specified disk
                -d           : restrict updates to the current disk only

 Output:        Confirmation and progress information, and when no -P- option
                is used, an LVM-update dialog window allowing change of most
                LVM values using entry-fields and check boxes.

 Remarks:       When the -P- option is specified, the fields will be displayed
                only, from this display, the 'd' or <Enter> key will display
                the full LVM-information structure, and the 'x' key the related
                partition table. LVMSHOW will use this to display that sector.

                When no LVM-info exists for the partition, it will be created
                automatically with a constructed default value for the partition
                name, or the name specified with the -n option.
                With the -V option, a volume name will be assigned as well.

                The -d option will update the CRC values, useful after manual
                editing of the LVM-info sectors, and in combination with the
                -n options it will update the descriptive LVM diskname.
                No other options can be used with -d or -c

                The -c option alone will also check for obsolete DLAT entries,
                and can remove these to avoid the error messages from LVM that
                say: 'The partition table on this disk may be corrupt'.

                Be careful when updating a multiple partition volume (like JFS)
                the volume name and driveletter must be the same on all!

                The command can be called directly from the Operating System
                command line, as in:

                        DFSOS2.EXE  -b  lvm  2  -v:System  -menu

                This will place the 2nd partition on the BMGR menu as "System"

                Unlike the "delete volume" operation in LVM itself, the "-v-"
                option in DFSee does NOT delete the partition as well. All the
                other LVM-info will remain intact, including the driveletter.
                A subsequent "-v:volume" will recreate the volume with a new
                name and use the same ("existing") partition and driveletter.

                Note that YOU are responsible for keeping the driveletters
                unique for the whole system.

                Using the "-p-" option deletes the explicit partition name,
                LVM will use a default name like "[ A3 ]" in this case.

                While the dialog is up, commands that are started using a
                function key can still be executed. (F4 .. F9 are useful)
                The output in the "text output window" can still be scrolled
                using <Ctrl> + arrow keys or <Ctrl> + PgDn/PgUp.

                As another example, remove all RELEVANT info from the LVM info
                for a partition. This will delete everything that is normally
                used or displayed for an LVM volume. Example, for partition 06:

                     lvm 06  -D  -v-  -p-  -l-  -m-  -i-

                After applying it will NOT be considered a volume anymore.
                However, the LVM sector for the partition will still contain
                the disk name, the partition size, and LVM signature and a CRC.
                Using this partition with DFSee, LVM.EXE or LVMGUI would look
                the same as using a freshly created partition without any LVM info.
_______________________________________________________________________________

 LVMCRC     [disk]               = OBSOLETE! Use "LVM -c" or "LVM -d"
_______________________________________________________________________________

 LVMREDO   disk|.|*         [-C] = Refresh LVM info sectors (DLAT) for disk(s)

 Purpose:       Rewrite all the LVM information sectors like the DLAT and BBR
                to make them consistent (DLAT = Drive Letter Assignment Table)

 Parameters:    disk    mandatory  Disk number or '*', default all disks = '*'

 Options:         -C    optional   CREATE new default LVM information for
                                   partitions that do not have any yet.

 Output:        Progress information

 Remarks:       With the '-C' option specified, the LVMREDO is similar to
                the 'VCU' command, with main differences:
                - Existing LVM information is not cleared or changed
                - LVM info that is created new will not specify a driveletter
_______________________________________________________________________________

 LVMSHOW   [pid | *]             = Show related LVM-info for 1 or all partitions

 Purpose:       Perform a simple display of the LVM-info sector for the current
                or specified partition. (DLAT = Drive Letter Assignment Table)

 Parameters:    pid     optional   Partition id for partition to be listed,
                                   or '*' to list for all partitions.
                                   List CURRENT partition if not specified.

 Output:        Contents of the LVM-info sector(s) with names and driveletter(s)

 Remarks:       Uses a hidden 'lvm' cmd to find the info, and a display of
                the then default sector to display it. It will fail when the
                partition has no LVM-info, and might display the wrong sector.
                To list for ALL partitions, a 'pl l' command will be executed.
_______________________________________________________________________________

 NEWMBR    [disk | *]   [-clean] = Refresh MBR boot code from various sources

 Purpose:       Create or refresh the boot code in the master boot record (0)

 Parameters:    disk    optional   Disk to operate on, default is all disks
                                   You can specify either this or use the
                                   -d option for a specific disk, otherwise
                                   the command will be applied to ALL disks

 Options:       -d:disk   = Apply to specified disk or current disk
                -c[lean]  = Clear the partition tables too, resulting
                            in an empty disk, with valid MBR code
                            This also clears the Windows 'NT-signature'
                -f:disk   = Clone MBR-code from the specified disk to this one
                -I[:img]  = Use specified or default (newmbr.img) imagefile
                            for the boot code instead of the built-in code

 Output:        Progress information and confirmation messages

 Remarks:       Without the -c option, this command will ONLY replace
                the boot code part of the MBR, the partition tables and hence
                all the currently defined partitions will stay intact!
                Also the Windows disk identification number (NT-signature)
                will keep its value, so Windows should NOT re-assign
                all driveletters on the next boot :-)

                When using the '-c' option, the Windows disk identification
                number (NT-signature) will be set to all ZEROES as well.
                This makes sense, since the existing driveletter assignments
                that Windows keeps registered will be obsolete now the tables
                are empty ...
_______________________________________________________________________________

 NTCDR      CD-nr     letter | - = Set driveletter for CDROM (NT version only)

 Purpose:       Set or clear the driveletter for specified CDROM device

 Parameters:    CD-nr   mandatory  Sequence number for CDROM, first is 1

                letter  mandatory  Driveletter to be used for the CDROM device
                                   as displayed in the DFSee "NTMAP" command
                                   Specify '-' to clear the driveletter

 Output:        Progress information and confirmation messages

 Remarks:       Only available in the Windows version of DFSee (DFSWIN.EXE)
                For use on Windows NT-4 only, not recommended on 2000 or XP.
_______________________________________________________________________________

 NTDDD action WIN32dev [NT-dev] = Direct manipulation of DosDevice mapping

 Purpose:       Low level corrections, test and debugging of DosDevice mapping
                (NOT intended for normal use)

 Parameters:    action   mandatory Flag value to be passed to DefineDosDevice
                                   The default is 1  (RAW)

                                   Values:      DDD_RAW_TARGET_PATH         1
                                                DDD_REMOVE_DEFINITION       2
                                                DDD_EXACT_MATCH_ON_REMOVE   4
                                                DDD_NO_BROADCAST_SYSTEM     8

                WIN32dev mandatory Specification for the WIN32 device, usually
                                   this will be a driveletter (check NTDEV)

                NT-dev   optional  Native NT device name (path) to define
                                   for the specified WIN32 device name.
                                   When not specified, the mapping is deleted

 Output:        Success or failure status for the DefineDosDevice API call

 Examples:      DDD 1 R:                                ;Unassign R: mapping
                DDD 1 Q: \Device\Cdrom0                 ;Assign Q: to CDROM 1
                DDD 1 F: \Device\HardDisk0\Partition3   ;Assign F: to 3rd part
                                                        ;on the first harddisk

 Remarks:       Only the (dynamic) mapping used by NT is updated, the registry
                key for driveletter mapping is not modified.

                Only available in the Windows version of DFSee (DFSWIN.EXE)
                For use on Windows NT-4 only, not recommended on 2000 or XP.
_______________________________________________________________________________

 NTDEV      [ device ] [mapping] = Show DosDevice mapping, wildcards limit output

 Purpose:       Show the mapping between WIN32 devices, including driveletters,
                and the underlying system-wide NT device names

 Parameters:    device   optional  Wildcard specification for the WIN32 name
                                   The default is "?:" resolving driveletters

                mapping  optional  Wildcard specification for native NT name
                                   The default is "*" for all devices
                                   useful are: "*partition*"  for partitions
                                               "*lanmanager*" for NET USE...

 Output:        A two column table with WIN32 versus NT native device names

 Remarks:       useful to check the assignment of driveletters to partitions
                on a disk, but also for network drives (aka NET USE ...)

                Only available in the Windows version of DFSee (DFSWIN.EXE)
                For use on Windows NT-4 only, not recommended on 2000 or XP.
_______________________________________________________________________________

 NTMAP      [ verbose |  sync  ] = Show reg-diskkey, update & sync with DosDevice

 Purpose:       Show a table with disk-number, relative (registry) partition nr,
                the driveletter assigned, the size in Megabytes and the native
                NT device name related to the driveletter.

 Parameters:    verbose  optional  Expand table to multiple, detailed lines
                                   for each listed driveletter

                sync     optional  Synchronization request of the DFSee info
                                   with NT registry, MBR signatures and the
                                   dynamic driveletter assignments

                                   Note: automatically executed for "SETLET"
                                         commands without a "ns" parameter

 Output:        Progress information

 Remarks:       The driveletters as shown by the DFSee "Part" table will be
                leading, and replace any existing values. Actions performed:

                - When needed: NT signature in the MBR will be written
                - NT registry "disk" key will be (re)created
                - dynamic DosDevice mapping between WIN32 and native NT
                  device names is updated when needed

                Only available in the Windows version of DFSee (DFSWIN.EXE)
                For use on Windows NT-4 only, not recommended on 2000 or XP.
_______________________________________________________________________________

 NTSIGN    [disk    [signature]] = Set NT-signature in MBR, HEX signature value

 Purpose:       Set a well-known value as NT disk-administrator signature

 Parameters:    disk    optional   Disk to operate on, default is all disks

                sign    optional   The signature value, in hexadecimal format
                                   Default value is hex DF5EE800 + disknr

 Output:        Progress information and confirmation messages

 Remarks:       Setting a fixed value for the NT signature value in the MBR
                can avoid unwanted reassigning of drive-letters when using
                Windows NT. It uses this value to correlate the drive-letter
                mapping kept in the registry. When cloning an NT image to a
                new disk, set the signature to the same (known) value.
_______________________________________________________________________________

 PCLEAR     disk [P][Lvm[S]][Br] = Clear info in P-tables, LVM and/or Boot record

 Purpose:       Clear contents of partition table, LVM or boot record sectors.
                The sectors will be completely filled with zero-bytes (0x00)

 Parameters:    disk    mandatory  Physical disknumber, or * for all disks

                type       Ptable  Partition table sectors (MBR and EBRs)
                           Lvm     LVM disk/volume information sectors
                           S       LVM signature sectors (only valid with'L')
                           Bootrec Boot records for each partition

                                   Only the first letter is required and
                                   multiple types can be specified.

 Output:        Confirmation messages (interactive mode only)

 Remarks:       Confirmations (yes/no) will be issued for each physical disk
                when clearing partition table and LVM-info sectors, and for
                each individual partition when clearing the boot record.
_______________________________________________________________________________

 PLIST     p|f|e|m|b|w|l [opts] = list: part|free|ebr|mbr|boot|walk|lvm

 Purpose:       Show one of several lists of partition related information

 Parameters:    type    optional   type of list wanted: p|f|e|m|b|w|l

                            part   normal partitions
                            free   freespace areas
                            ebr    EBR-chain
                            mbr    MBR partition table entries
                            boot   Bootsectors for all partitions
                            walk   MBRs and all EBRs (as WALK cmd)
                            lvm    LVM volume information sectors and
                                   the LVM signature sectors

 Options:       -d[:nr]     Disk to operate on, default is all disks when
                            not specified and current disk for '-d'

                -r          Related, include extra-info on related sectors
                            (MBR/EBR versus LVM-info)

 Output:        The list of the requested type with info on start-sector
                and end-sector numbers, sizes and more.

 Remarks:       All sector numbers are also stored in the DFS sector list,
                for use with the LIST and EXPORT commands.
_______________________________________________________________________________

 PRESTORE *|disk Fname [types] = Write info from file into P-tables and LVM

 Purpose:       Restore (selected) partition table, LVM and boot record
                sectors from a binary file created with the PSAVE command.

 Parameters:    disk    mandatory  Physical disknumber, or symbolic value:
                                  .  = Current disk
                                  *  = ALL disks when no file extension present
                                  *  = SAME disk as file with a file extension

                Fname   mandatory  Filename for file(s) to restore, when no
                                   extension is specified, the 'disk' parameter
                                   will be used to select the right .PDn file.
                                   An explicit extension can be used to restore
                                   from a different file (other disk number).

                types   optional   Only restore sectors of specified type(s)

                                  r  = Master boot record
                                  e  = Extended boot records
                                  b  = Filesystem boot records
                                  l  = LVM information sectors
                                  s  = LVM signature sectors

                options:         -v  = verbose display and prompting
                                 -l  = list sectors only (no write back)
                                 -c- = no confirmation for each sector,
                                       only for the complete .PDx file


 Output:        Confirmation messages, depending on the specified options

 Remarks:       Sectors are not restored when the '-l' option is specified.

                Quick restore with a single confirmation prompt for the
                whole file can be forced using the "-c-" option.
_______________________________________________________________________________

 PSAVE    *|disk Fname [comment] = Save Partition table and LVM info in file

 Purpose:       Save contents of all partition table, LVM and boot record
                sectors in one binary file per physical disk, selectively
                restorable with the associated PRESTORE command.

 Parameters:    disk    mandatory  Physical disknumber, or * for all disks

                Fname   mandatory  Base filename for saved file(s), the
                                   extension will be '.PDn' (n = disk nr)

                comment optional   A text string that will be included in the
                                   saved file(s) for easy identification.

 Output:        Progress info, one letter r, e, l or b for each saved sector

 Remarks:       Each resulting file will start with an ASCII header that
                contains info on the DFSee version used, date and time and
                some info on the disk and partitions. It also includes the
                comment specified with the PSAVE command.
                This info can be easily referenced by a simple TYPE of the
                file, the ASCII part ends in an EOF character (ctrl-Z) so
                the rest of the binary info does not mess up the display.
_______________________________________________________________________________

 SETACCESS  pid [hide|vis|multi] = Make partition 'pid' accessible or hidden

 Purpose:       Set visibility for the specified partition.

 Parameters:    pid     mandatory  Partition id, see PART and MAP display
                pid,r              Relative PID, on current or specified disk

                hide    optional   Make this partition hidden (invisible)
                vis     optional   Make this partition visible, hide others
                multi   optional   Make this partition visible, but do allow
                                   multiple visible primary partitions per disk

 Options:       -d[:nr]      : Use current or [specified] disk for relative PID
                               PID MUST be specified as relative 'pid,r' in this
                               case, example, set 2nd part on 2nd disk hidden:

                                     SETACCESS  2,r  -d:2  hide


 Output:        Progress information and confirmation messages

 Remarks:       The partition will be made visible (types 01 .. 0f).
                All other primaries on the same disk will be made hidden,
                except when the 'multi' parameter was given.
_______________________________________________________________________________

 SETBOOT    [-]opt[:options]     = IBM BootManager setup and reboot options

 Purpose:       Configure BMGR; Set partition to boot, and (optionally) boot

 Parameters:    opt     mandatory  Option letter/word for the setboot action

                options optional   Depending on the selected option:

                     -q:[disknr] = query Bootmanager settings (on disknr)
                     -t:timeout  = menu timeout, number of seconds or NO
                     -m:mode     = set menu display to normal or advanced
                     -x:number   = set system-index to specified number
                -[0..5]:BM-name  = set system 0..5 to a Bootmanager name
                   -ibd:d        = reboot from the drive letter specified
                   -iba:BM-name  = reboot from Bootmanager name specified
                     -d:d        = set next-boot to this driveletter (d:)
                     -b          = shutdown filesystems and reboot now
                     -F-         = no buffer flush, show PM popup message
                     -list       = List available names on Bootmanager menu


      System-indexes 0..5 have the following meaning:

      0  default system   Booted when no other selection is made from the
                          menu, or when the timeout is set to NO.

   1..3  fallback range   On a failing boot on one of these systems, the
                          next boot will be of the next lower-number
                          system (fallback scenario)

      4  force-reboot     Indicates the system-name to boot next time,
                          without display of the menu (forced).
                          This is used by the /iba:name option.
                          The name is automatically cleared on the next boot.

      5  last-booted      The system-name last booted using IBM BootManager.
                          This will also be the default when the default
                          system itself (0) is not set.

 Output:        Progress information and confirmation messages

 Remarks:       Both the 'classic' version of IBM BootManager (2.1 up to Warp4)
                and the "Warp Server for e-Business" or "eComStation" version
                working together with LVM are supported. The latter uses
                longer names for the partitions that are bootable.

                All Bootmanager names are CASE-SENSITIVE, boot will fail if
                an incorrect case name is specified on -iba or others.

                - The reboot from DFSOS2.EXE requires DOS.SYS to be loaded!
                - The reboot from DFSDOS.EXE will only work on Win9x when the
                  external reboot program DFSDOSX.EXE is present.
                  This executable is delivered in the package as dfsboot9.exe
                  and needs to be renamed before it will work on Windows-9x.
_______________________________________________________________________________

 SETLET     pid  letter | - [-n] = Set driveletter for DFSee; [-n] = no sync

 Purpose:       Set or clear the driveletter for a partition

 Parameters:    pid     mandatory  Partition id, see PART and MAP display
                pid,r              Relative PID, on current or specified disk

                letter  mandatory  Driveletter to be used with the partition
                                   as displayed in the DFSee tables.
                                   Specify '-' to clear the driveletter

                -n      optional   No Synchronize with NT registry and the
                        WINDOWS:   dynamic NT drive-letter assignment.
                                   Otherwise a complete sync between DFSee
                                   and the registry will be done, comparable
                                   with the "NTMAP sync" command.

                -n      optional   No Synchronize with the LVM Engine to get
                        OS2/eCS:   dynamic LVM drive-letter assignment.
                                   Otherwise the changed letter will be
                                   communictaed to the Engine and become
                                   effective immediately.

 Options:       -d[:nr]      : Use current or [specified] disk for relative PID



 Output:        Progress information and confirmation messages

 Remarks:       Setting the driveletter as used in DFSee tables works for all
                versions. However, the real use is with the NT version where
                the driveletter as used by NT itself will change too!
                It will be updated in the "Disk" key in the registry and in
                the dynamically maintained DosDevice mapping

                It might be wise to reboot or shutdown quickly after changing
                critical drive-letters like the WINNT system or boot drive.

                To change driveletters and other related info for systems
                with LVM (OS/2 4.5, eComStation) use the LVM command.
_______________________________________________________________________________

 SETNAME    pid        [BM-name] = Set or reset IBM BootManager name for partition

 Purpose:       Set or clear the name for a partition, adding it to the menu

 Parameters:    pid     mandatory  Partition id, see PART and MAP display
                pid,r              Relative PID, on current or specified disk

 Options:       -d[:nr]      : Use current or [specified] disk for relative PID

                BM-name optional   When specified, this is the name to be
                                   used in the IBM BootManager menu. (length 8)

                                   When not specified, the partition will
                                   be removed from the menu by clearing the
                                   name in the IBM BootManager administration.

 Output:        Progress information and confirmation messages

 Remarks:       To change the volume name and other related info for systems
                with LVM (OS/2 4.5, eComStation) use the LVM command.
_______________________________________________________________________________

 SETTYPE    pid  disk new  [old] [-e] = Change partition type from old to new

 Purpose:       Change the system-type for a partition to a new value

 Parameters:    pid     mandatory  Partition id, see PART and MAP display
                pid,r              Relative PID, on current or specified disk

                disk    mandadory  Disknr, * or 0, used for verification

                new     mandatory  New system-type, hexadecimal or symbolic

                        The most used system-types are:

                        hex   sym

                        01   FAT12  =  FAT12
                        04   FAT16  =  FAT16 < 32 MiB
                        05   EXT    =  Extended partition (chain)
                        06   FAT    =  FAT16 > 32 MiB
                        07   IFS    =  Installable File system
                        07   HPFS   =  IFS, HPFS (alias)
                        07   NTFS   =  IFS, NTFS (alias)
                        0a   BMGR   =  IBM BootManager
                        0b   FAT32  =  FAT32 small and below cyl 1024
                        0c   FAT32X =  FAT32 large or beyond cyl 1024
                        0f   BIGX   =  Large extended (PQMagic 4.0)
                        82   SWAP   =  Linux swap partition
                        83   EXT2   =  Linux EXT2 data partition
                        eb   BEOS   =  BeOS filesystem
                        fe   PS2S   =  PS/2 system partition

                old     optional   Existing system-type, for verification

 Options:       -e        = Force change to an extended container type


 Output:        Progress information and confirmation messages

 Remarks:       Only the type of the partition in the partition table will
                be changed. The actual internal format of the partition is
                not affected by this operation.

                You can get an overview of all types with the 'TYPE' command.

                To change the type of an extended container (05 / 0f), use
                the 'fixext' command, or force it using the '-e' option.
                Note that changing a regular primary or logical partition
                to an extended container with '-e' will cause problems if
                it results in an illegal combination of defined partitions.
_______________________________________________________________________________

 STARTABLE  pid  [multi | clear] = Make partition 'pid' startable ([not]ACTIVE)

 Purpose:       Make the selection partition the 'active' one to be booted

 Parameters:    pid     mandatory  Partition id, see PART and MAP display
                pid,r              Relative PID, on current or specified disk

 Options:       -d[:nr]      : Use current or [specified] disk for relative PID


                multi   optional   Allow multiple visible primary partitions
                                   on each disk. This is invalid for older
                                   operating systems like OS2 Warp 3 or 4,
                                   windows-9x, 3.x or DOS.
                clear   optional   Clear the 'active' flag to 'not startable'

 Output:        Progress information and confirmation messages

 Remarks:       The partition status will be set to 'active' (0x80) and,
                if needed the partition will be made visible.
                All other primaries on the same disk will be made hidden,
                except when the 'multi' parameter was given.
                When 'clear' is specified, the active bit will be reset (0x00)
                and no change in visibility for any partition will be made.
_______________________________________________________________________________

 TYPE        [type | first last] = Show system-type description (for 00..ff)

 Purpose:       Show short description for one or more known system types

 Parameters:    type    optional   one system type to query
                first   optional   first type value for a range to show
                last    optional   last  type value for a range to show

 Output:        Single line when 'one type' queries, or 4 descriptions per
                line covering all known system-types from 00 through ff
                or from 'system-type' up to 'last' if a range is given.

 Remarks:       none
_______________________________________________________________________________

 VCU        disk  | * |  -d[:nr] = Clear existing LVM-info, create new defaults

 Purpose:       Create new LVM information like volume name and partition name
                Remove current LVM information when present.

 Parameters:    disk | *           Disk number or '*' for all disks

 Options        -d[:nr]            Disk number, or current disk

 Output:        Progress information

 Remarks:       This can be used to create default LVM-information with
                names derived from partition id, filesystem-types and size,
                and assign the drive-letters as currently known to DFSee.
                The default volume names will be taken from the current
                IBM BootManager names or the drive LABEL when available.

                LVM additional information in the signature sectors, as used
                by LVM/JFS partitions (type 0x35) will not be cleared, so it
                is safe to use this command on a system with JFS partitions.
_______________________________________________________________________________

 MOUNT  [opt] Fname | size [H S] = Mount a partionable medium (virtual / image)

 Purpose:       Mount a new partionable medium (virtual, image, physical)


 Options:       -v         Create and mount a VIRTUAL disk, this is the default

                -r:ImName  Mount a RAW imagefile, like an SVISTA .HDD container

                -p:number  Mount a physical disk by number (DOS, WIN, OS/2)

                -p:device  Mount a physical disk by device name (Linux)

                -o-        Do NOT open the new mounted disk disk automatically


 Parameters:    Fname    = Virtual with size and geometry as in the *.PD*
                           file specified, created with an explicit PSAVE
                           command, or with the generic DFSDISK procedure.
                           The file will be automatically restored on the
                           newly created virtual disk using a PRESTORE.
                           This leads to a virtual disk with exactly the
                           same partitions as the original disk had.
                           If a *.SN* file with exported list sectors
                           also exists, that will be imported as well.
                           This is a very fast and convenient way to test
                           with disk information from the DFSDISK script.

                size[[,d|x]m|g|c|s]  Specific size value, hex or decimal.
                                     in MiB, GiB, Cylinders or Sectors.
                                     Default: decimal Megabytes

                H S      = Heads & Sectors to use with specified size,
                           for creation and mounting of Virtual disks only

                When no options or parameters are specified, or just the '-v'
                option is is used, an EMPTY virtual disk will be created and
                mounted with the same size and geometry as the currently open
                disk (if any).


 Output:        Mount details for the new disk, and a default partition view
                for that same disk.

 Remarks:       A virtual disk created will be empty at start (zeroes),
                unless it is initialized using a PDx file.
                Only sectors written to will actually be created in memory,
                and this might be limited by the available memory.

                By default the mounted disk is opened (made the current object)
                This will allow direct and easy use from scripts, without
                knowing the actual assigned disk number.

                A virtual disk is very useful when experimenting. An existing
                partition scheme can be copied by using PSAVE and PRESTORE.
                It is also used in DFSDISK analysis and script testing.

                Mounting RAW imagefiles is very useful to fix minor problems
                preventing booting such an image in a virtual machine.
_______________________________________________________________________________

 UNMOUNT    disk | * | -l        = Unmount mapped partionable medium

 Purpose:       Remove a partionable medium from the list of available disks

 Parameters:    disk       Unmount the disk with the specified DFSee-id

                *          Unmount all disks currently mounted

                -l         Unmount the LAST disk (highest DFSee-id)

 Output:        Mount details for the disk being removed

 Remarks:       There is usually no need to remove mounted disks, they
                automatically disappear when DFSee ends
_______________________________________________________________________________

 VSTATUS                         = Show R/W and usage status of virtual disks

 Purpose:       Show nr of sectors in use and read/write statistics for virtuals

 Parameters:    none

 Output:        A few lines with statistics for every virtual disk
_______________________________________________________________________________

 WALK       [disk]               = Select disk and walk MBR/EBR chain, reset

 Purpose:       Show all partitioning information for the specified disk

 Parameters:    disk    optional   disk nr, default is current if open or 1

 Options:       -r                 reset previously forced geometry
                -R                 open the disk in Read-only  mode
                -R-                force the disk in Read-write mode

 Output:        Disk Geometry, MBR and all linked EBRs in partition format.
                EBR chaining errors like backward links and logical loops
                will be detected and warnings or errors will be displayed.

 Remarks:       The dfs_number variable for REXX will be set to number of disks
                See also: DISK command (dfscmds.txt)
_______________________________________________________________________________
