home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / dfsee510.zip / dfsfdisk.txt < prev    next >
Text File  |  2003-01-14  |  50KB  |  1,064 lines
  1.   Display File Systems; version 5.10 14-01-2003  (c) 1994-2003; Jan van Wijk
  2.  ----------------------------[ www.dfsee.com ]-------------------------------
  3.  
  4.  
  5. C O N T E N T S:
  6. ================
  7.  
  8.   Command referenc = overview of FDISK specific commands
  9.   Detailed description = description for every command
  10.  
  11.  
  12. C O M M A N D   R E F E R E N C E:
  13. ==================================
  14.  
  15. FDISK specific commands
  16.  
  17. Active filesystem : FDISK / IBM-BMGR,  specific commands are:
  18.  
  19.  BMP                             = Show bootmanager primary-names sector
  20.  CLEANUP   [disk               ] = Cleanup partition-chain, fix minor errors
  21.  CR        [parameters][options] = Create a new partition, use 'CR' for usage
  22.  DELETE     pid [disk   [clean]] = Delete one or more partitions, clean=zero
  23.  DISK|WALK [disk]           [-r] = Select disk, show the MBR, walk EBR chain
  24.  DFSIBMGR  [disk               ] = Create new bootmanager image for 'create'
  25.  FAT2OS     pid [disk [boot-OS]] = Set FAT-BR bootcode to OS2|NT|IBMdos|MSdos
  26.  FIXCHS     disk                 = Fix CHS values to match LBA/current geometry
  27.  FIXEXT    [disk   [to  [from]]] = Fix ext-partition types to standard value
  28.  LVM       [pid | *]   [options] = Update name, letter and BM-menu for partition
  29.  LVMSHOW   [pid | *]             = Show related LVM-info for 1 or all partitions
  30.  NEWMBR    [disk    [cleanpart]] = Refresh MBR bootcode, [clean] = delete all
  31.  NTSIGN    [disk    [signature]] = Set NT-signature in MBR, hex signature value
  32.  PLIST      p|f|e|m|b|w|l [d[r]] = List: part|free|ebr|mbr|boot|walk|lvm [opt]
  33.  PCLEAR     disk [P][Lvm[S]][Br] = Clear info in P-tables, LVM and/or Boot-rec
  34.  PSAVE      disk Fname [comment] = Save Partition-table and LVM info in file
  35.  PRESTORE   disk Fname   [types] = Write info from file into P-tables and LVM
  36.  SETACCESS  pid [hide|vis|multi] = Make partition 'pid' accessible or hidden
  37.  SETBOOT    opt[:opt-parameters] = Bootmanager setup and reboot => 'setboot ?'
  38.  SETLET     pid  letter | - [ns] = Set driveletter for DFSee; [ns] = no sync (NT)
  39.  SETNAME    pid        [BM-name] = Set or reset (non-LVM) BMGR name for partition
  40.  SETTYPE    pid  disk new  [old] = Change partition-type from old to new value
  41.  STARTABLE  pid  [multi | clear] = Make partition 'pid' startable (bootable)
  42.  TYPE       [system-type [upto]] = Show one or more system-type descriptions
  43.  VCU        disk  | * |  -d[:nr] = Clear existing LVM-info, create new defaults
  44.  VIRTUAL  $ | Fname | size [H S] = Virtual disk from CURRENT, Fname or size/geo
  45.  VREMOVE                   [ * ] = Remove last one made, or all virtual disks
  46.  VSTATUS                         = Show R/W and usage status of virtual disks
  47.  W2KBM     [disk               ] = Make IBM's bootmanager Windows-2000 proof
  48.  
  49.  
  50.  
  51.  For an up-to-date list of commands, use the '?' command
  52.  
  53.  FDISK specific sector types (see ??? command)
  54.                'X' = Unidentified data
  55.  
  56.  
  57. D E T A I L E D   D E S C R I P T I O N:
  58. ========================================
  59.  
  60.  BMP                             = Show bootmanager primary-names sector
  61.  
  62.  Purpose:       Show the IBM bootmanager sector that has BM-names for primaries
  63.  
  64.  Parameters:    none
  65.  
  66.  Output:        Hex-dump display of first half of that sector (if present)
  67.  
  68.  Remarks:       This sector is an array of 4-lines for each physical disk,
  69.                 one for each possible primary partition.
  70.                 Each line has an active flag-byte, head+sector/cylinder,
  71.                 another flag set when on the BM-menu and the name string
  72.  
  73.  
  74.  
  75.  CR        [parameters][options] = Create a new partition, use 'CR' for usage
  76.  
  77.  You can use positional-parameters and/or position-independant options.
  78.  For a detailed description of all the positional-parameters and the
  79.  position-independant options see further below, short description:
  80.  
  81.           parameters   : pri|log  [type  [size  [loc  [pos  [BM-name]]]]]]
  82.  
  83.          -p or -l      : create a Primary or Logical partition. (mandatory)
  84.          -t:numeric  ┐ : system Type, numeric, default DECIMAL  (mandatory)
  85.          -t:'symbol' ┘ : system Type, as a symbolic-name        (mandatory)
  86.          -s:size       : Size, will be rounded UP to next cylinder boundary
  87.          -d:disk-nr  ┐ : location, use first fitting area on specified Disk
  88.          -f:id       ┘ : location, as Freespace id (1st column from 'part')
  89.          -a:abs-pos  ┐ : Absolute position from start of disk  (mcs-number)
  90.          -r:rel-pos  │ : Relative pos from start of freespace  (mcs-number)
  91.          -e:end-pos  │ : Relative pos from end   of freespace  (mcs-number)
  92.          -i:i13-pos  │ : Relative pos before the Int-13 limit  (mcs-number)
  93.          -x:e13-pos  ┘ : Relative pos after the Int-13 limit   (mcs-number)
  94.          -b:BM-name    : partition name for (IBM, non-LVM) Bootmanager menu
  95.          -o            : open the new partition after create
  96.          -I[:image]    : imagefile to be written to new partition
  97.          -L            : automatic 'lvm -V' on new partition
  98.          -L:'lvm opts' : automatic 'lvm' using specified options
  99.  
  100.  
  101.        The mcs-number format is [0x]nnnn[,m|c|s] a HEX or decimal value,
  102.        in units of Mb, Cylinders or Sectors. Default is decimal Mb.
  103.  
  104.        You can mix the old and new style syntax, as long as the 'old' type
  105.        parameters are in the required fixed position as specified above
  106.        and the 'pri|log' and 'type' are specified somehow.
  107.  
  108.        Examples: cr log hpfs 200  3  *  OS2MAINT
  109.                  cr log hpfs 200  -d:3  -b:OS2MAINT
  110.                  cr log hpfs -s:200  -d:3  -b:OS2MAINT
  111.                  cr log -t:hpfs -s:200  -d:3  -b:OS2MAINT
  112.                  cr -log  -t:hpfs  -s:200  -d:3  -b:OS2MAINT
  113.                  cr -d:3 -b:OS2MAINT -t:hpfs -s:200 -logical
  114.                  cr -disk:3 -bm:OS2MAINT -type:hpfs  -size:200  -logical
  115.  
  116.                  These are all variations of the same CReate command ...
  117.  
  118.  
  119.  Purpose:       Create one new partition in an area that is now freespace
  120.  
  121.  Parameters     pri|log mandatory  Primary/Logical identifier;
  122.  (old style)
  123.                                    log  | l   Logical partition
  124.  
  125.                                    pri  | p   Primary partition
  126.  
  127.  
  128.                 type    mandatory  System-type for new partition;
  129.  
  130.                                    hex        Hexa-decimal value 0..ff
  131.  
  132.                                    symbolic   A name from the pre-defined
  133.                                               set of partition-types.
  134.                                               (see SETTYPE for a list)
  135.  
  136.  
  137.                 size    optional   Desired size for the partition;
  138.  
  139.                                    *          Use maximum size for the
  140.                                               selected freespace-area
  141.  
  142.                           number[[,d|x]m|c|s] Specific value, hex or decimal.
  143.                                               Megabytes, Cylinders or Sectors.
  144.                                               Default: decimal Megabytes
  145.  
  146.  
  147.                 loc     optional   Location to place new partition;
  148.  
  149.                                    *          Use first 'matching' area
  150.  
  151.                                    @fsp-id    Specific freespace area
  152.  
  153.                                    disk       Use first matching area on
  154.                                               the specified disk
  155.  
  156.  
  157.                 pos     optional   Position in loc-area;
  158.  
  159.                                    *          Default position (at start)
  160.  
  161.                [+|-|@|{|}]number[[,d|x]m|c|s] Specific value, hex or decimal
  162.                                               Megabytes, Cylinders or Sectors.
  163.                                               Default: decimal Megabytes
  164.                                               Prefix modifiers are:
  165.                                    +          Relative to start or area
  166.                                    -          Relative to end of area
  167.                                    @          Absolute from start of disk
  168.                                    {          Relative, before 1024-cyl limit
  169.                                    }          Relative, after  1024-cyl limit
  170.  
  171.                                               Note: The corresponding value
  172.                                                     with the prefix can be 0
  173.                                                     or empty
  174.  
  175.                 BM-name optional   Add to the bootmanager-menu using this name
  176.  
  177.  
  178.  Options:       -p         : create a Primary partition
  179.  (new style)    -l         : create a Logical partition
  180.  
  181.                 -t:type    : system Type, numeric or symbolic-name  (mandatory)
  182.                              When numeric, the value is DECIMAL by default,
  183.                              hexadecimal can be specified using the '0x' prefix
  184.  
  185.                              Some symbolic names + HEX value and description:
  186.  
  187.                              FAT   = 01/04/06/0b/0c    Automatic FAT type
  188.                              BMGR  = 0a                OS/2 Bootmanager
  189.                              FAT32 = 0b/0c             Automatic 32-bit FAT
  190.                              JFS   = 35                Journalled FS (LVM)
  191.                              HPFS  = 07                OS/2 native filesystem
  192.                              NTFS  = 07                Windows-NT filesystem
  193.                              SWAP  = 82                Linux SWAP partition
  194.                              EXT2  = 83                Linux EXT2 filesystem
  195.  
  196.                              Note: The automatic FAT tupes will use the required
  197.                                    value based on partition size and position.
  198.  
  199.                              Example formats, all of the following are equal:
  200.  
  201.                              -t:ext2          symbolic name (case insensitive)
  202.                              -t:'83'          hex value, as a string
  203.                              -t:83h           hex value, with the 'h' postfix
  204.                              -t:0x83          hex value, with the '0x' prefix
  205.                              -t:131           decimal value, numeric format
  206.  
  207.                              Note:
  208.  
  209.                              -t:83            is decimal 83 ==> type 0x53 !!!
  210.  
  211.                 -s:size    : Size, will be rounded UP to next cylinder boundary
  212.                                    except when specified in sectors
  213.  
  214.                              Examples:
  215.  
  216.                              -s:800           size of 800 Mb, rounded UP
  217.                              -s:30,c          size of 30 cylinders, rounded UP
  218.                              -s:0x3fc0,s      size of exactly 0x3fc0 sectors
  219.  
  220.                 -f:id      : location, as Freespace id (1st column from 'part')
  221.                 -d:disk-nr : location, use first fitting area on specified Disk
  222.                 -d or -d:0 : location, currently open disk (useful with VMA -o)
  223.  
  224.                 -a:abs-pos : Absolute position from start of disk  (mcs-number)
  225.                 -r:rel-pos : Relative position from start of area  (mcs-number)
  226.                 -e:end-pos : Relative pos from end of the disk     (mcs-number)
  227.                 -i:i13-pos : Relative pos before the Int-13 limit  (mcs-number)
  228.                 -x:e13-pos : Relative pos after the Int-13 limit   (mcs-number)
  229.  
  230.                 -b:BM-name : partition name for (IBM, non-LVM) Bootmanager menu
  231.  
  232.                 -o         : open the new partition after create
  233.  
  234.                 -I[:image] : imagefile to be written to new partition, this can
  235.                              be a RAW (.IMG) or compressed (.IMZ) image as used
  236.                              with the SIM and WRIM commands. It is intended to
  237.                              initialize the new partition with existing data.
  238.                              When no name is specified, you will be prompted.
  239.  
  240.  
  241.  Output:        Progress information and confirmation messages
  242.  
  243.  Remarks:       none
  244.  
  245.  
  246.  DELETE     pid     [disk  [clean]]         = Delete on or more partitions
  247.  
  248.  Purpose:       Delete one or more partitions.
  249.  
  250.  Parameters     pid   : Partition-id for 1 partition or '*' for all partitions
  251.                 disk  : Physical disk number for 1 disk or '*' for all disks
  252.                 clean : Zero out complete table-entry, not just the system-type
  253.  
  254.  Output:        Progress information and confirmation messages
  255.  
  256.  Remarks:       The partition will by default be deleted by changing the
  257.                 system-type to hex '00'. This is the minimum required change.
  258.                 This allows for relatively easy recovery or rollback.
  259.                 The 'clean' option forces the complete table-entry, 16-bytes
  260.                 to be set to all zeroes.
  261.  
  262.                 Note that the extended-boot-records (EBR) are NEVER removed
  263.                 from the EBR chain by the delete command. Even if an EBR
  264.                 remains empty, it is left in the chain. Most operating systems
  265.                 have no problems with a setup like this.
  266.  
  267.                 You can use the 'cleanup' command to clean this up when needed.
  268.                 A subsequent 'CREATE' will also clean the EBR-chain up.
  269.  
  270.  
  271.  FAT2OS     pid [disk [boot-OS]] = Set FAT-BR bootcode to OS2|NT|IBMdos|MSdos
  272.  
  273.  Purpose:       Replace bootcode by OS/2, NT, IBMdos or MSdos bootcode for FAT
  274.  
  275.  Parameters     pid     : Partition-id for 1 partition or '*' for all
  276.                 disk    : Physical disk number for 1 disk or '*' for all
  277.                 boot-OS : specifier for bootcode, taken from operating system:
  278.                           OS2    - OS/2   version 4 (Warp, Merlin)
  279.                           NT     - Win-NT version 4
  280.                           IBMdos - IBM DOS 7.0
  281.                           PCdos  - IBM DOS 7.0
  282.                           MSdos  - MS  DOS 6.22
  283.  
  284.  
  285.  
  286.  CLEANUP    [disk              ] = Cleanup partition-chain, fix minor errors
  287.  
  288.  Purpose:       Cleanup minor inconsistencies in partition-chain, like remove
  289.                 of 'empty' extended partitions and recalculation of the total
  290.                 size of the extended-container.
  291.  
  292.  Parameters:    disk    optional   Disk to operate on, default is all disks
  293.  
  294.  Output:        Progress information and confirmation messages
  295.  
  296.  Remarks:       Inconsistencies can be caused by several operations, using
  297.                 DFSee, other FDISK versions or Partition Magic.
  298.                 Resizing and deleting with PQmagic or a 'delete' with DFSee
  299.                 can cause 'empty' extended containers.
  300.  
  301.  
  302.  DFSIBMGR   [disk              ] = Create new bootmanager image for 'create'
  303.  
  304.  Purpose:       Create a DFSIBMGR.IMG image-file from the bootmanager installed
  305.                 on the specified disk, to be used later on 'create' commands
  306.                 when creating new bootmanager partitions.
  307.  
  308.  Parameters:    disk    mandatory  Disk to get the bootmanager image from
  309.  
  310.  Output:        Progress information
  311.  
  312.  Remarks:       The 'create' command will automatically search for an image
  313.                 with this name when a type 0x0a = BMGR partition is created.
  314.  
  315.  
  316.  FAT2OS     pid [disk [boot-OS]] = Set FAT-BR bootcode to OS2|NT|IBMdos|MSdos
  317.  
  318.  Purpose:       Replace bootcode by OS/2, NT, IBMdos or MSdos bootcode for FAT
  319.  
  320.  Parameters     pid     : Partition-id for 1 partition or '*' for all
  321.                 disk    : Physical disk number for 1 disk or '*' for all
  322.                 boot-OS : specifier for bootcode, taken from operating system:
  323.                           OS2    - OS/2   version 4 (Warp, Merlin)
  324.                           NT     - Win-NT version 4
  325.                           IBMdos - IBM DOS 7.0
  326.                           PCdos  - IBM DOS 7.0
  327.                           MSdos  - MS  DOS 6.22
  328.  
  329.  Output:        Progress information and confirmation messages
  330.  
  331.  Remarks:    a: The command only replaces the BOOT-CODE part of the FAT
  332.                 bootsector. Other stuff, like the boot-parameter-block (BPB)
  333.                 is kept intact to preserve geometry and format information
  334.  
  335.              b: This command is intended to prepare a partition for booting
  336.                 the specified OS (FAT only), from a pure DOS environment.
  337.                 Step 1) Partition using DFSee FDISK (make at least 1 FAT)
  338.                 Step 2) reboot, to make DOS assign a drive-letter
  339.                 Step 3) Format the FAT partition using std DOS FORMAT
  340.                 Step 4) Use DFSEE FAT2OS command to make it correctly bootable
  341.                 Step 5) xcopy a saved set of specific operating-system files
  342.                         to the partition, including the system-files like
  343.                         OS2BOOT, OS2LDR, NTLDR, IBMBIO/IBMDOS, IO.SYS/MSDOS.SYS
  344.                         etc. depending on the operating system.
  345.                 Step 6) Boot that partition (direct or through BMGR)
  346.  
  347.  
  348.  FIXEXT  [disk | * [to  [from]]] = Fix ext-partition types to standard value
  349.  
  350.  Purpose:       Change non-standard values (0x0f) back to the standard 0x05
  351.                 value so operating systems like DOS and OS/2 can access the
  352.                 logical volumes inside this extended-partition container.
  353.  
  354.  Parameters:    disk    optional   Disk number or '*', default all disks = '*'
  355.  
  356.                 to      optional   New system-type for EBR, default is 0x05
  357.  
  358.                 from    optional   Existing system-type, default is 0x0f
  359.  
  360.                 Options:     -e    Force setting type other than 0x05 or 0x0f
  361.  
  362.  Output:        Progress information and confirmation messages
  363.  
  364.  Remarks:       The non-standard type 0x0f is introduced by Win9x combined
  365.                 with the FAT32 filesystem. These allow partitions larger
  366.                 then 2Gb and spanning the 8Gb BIOS limit (1024 cylinders).
  367.                 Using the 0x0f type prevents older operating systems to
  368.                 access, and possibly damage, the new partitions.
  369.  
  370.                 When all FAT16 partition are below cylinder 1024, there
  371.                 seems to be NO VALID REASON to use this type, and it can
  372.                 be safely changed back to 0x05 to allow access by DOS,
  373.                 OS/2 and others.
  374.  
  375.                 I can NOT GUARANTEE full co-operation with multiple
  376.                 operating systems, but my experiences are positive.
  377.  
  378.  
  379.  FIXCHS     disk                 = Fix CHS values to match LBA/current geometry
  380.  
  381.  Purpose:       Change all non-standard values for the CHS fields in partition
  382.                 tables to valied ones to avoid warnings or failures working
  383.                 with other disktools (FDISK, LVM, Partition-Magic etc)
  384.  
  385.  Parameters:    disk    mandatory  Disk to operate on or '*' for all disks
  386.  
  387.  Output:        Progress information and confirmation messages
  388.  
  389.  Remarks:       Non-standard values for the CHS fields sometimes cause
  390.                 problems in tools like LVM, it refuses to update anything
  391.                 because the "partition table might be corrupt" ...
  392.  
  393.                 There are two cases: for cylinders below 1024 the CHS values
  394.                 must match the calculated linear values (LBA) exactly, and
  395.                 above cylinder 1024 they should be acceptable 'dummy' values.
  396.  
  397.                 Note that the calculated LBA values depend on the logical
  398.                 geometry being used, so check if that geometry is the one
  399.                 you want (or need) to use.
  400.  
  401.                 Fixing this will get rid of all the DFSee warnings related
  402.                 to CHS problems (as displayed with 'part -w:chs'
  403.                 However, cylinder alignment warnings will stay because the
  404.                 partitions are not moved or resized. This is often less of
  405.                 a problem than CHS mismatches.
  406.  
  407.  
  408.  
  409.  LVMCRC     [disk]               = OBSOLETE! Use "LVMSET -c" or "LVMSET -d"
  410.  
  411.  
  412.  
  413.  LVMSHOW   [pid | *]             = Show related LVM-info for 1 or all partitions
  414.  
  415.  Purpose:       Perfrom a simple display of the LVM-info sector for the current
  416.                 or specified partition. (DLAT = Drive Letter Assignment Table)
  417.  
  418.  Parameters:    pid     optional   Partition id for partition to be listed,
  419.                                    or '*' to list for all partitions.
  420.                                    List CURRENT partition if not specified.
  421.  
  422.  Output:        Contents of the LVM-info sector(s) with names and driveletter
  423.  
  424.  Remarks:       Uses a hidden 'lvm' cmd to find the info, and a display of
  425.                 the then default sector to display it. It will fail when the
  426.                 partition has no LVM-info, and might display the wrong sector.
  427.                 To list for ALL partitions, a 'pl l' command will be executed.
  428.  
  429.  
  430.  
  431.  LVM       [pid | *]   [options] = Update name, letter and BM-menu for partition
  432.  
  433.  Purpose:       Set/show LVM related values for a partition (update or display)
  434.  
  435.  Parameters     pid     optional   Partition id for partition to update or '*'
  436.  
  437.  Options:       -v:volume    : set volumename (= bootmanager name if on menu)
  438.                 -v:"" or -v- : remove volumename. This deletes the volume for LVM
  439.                 -p:part      : set partition name for this partition
  440.                 -p:"" or -p- : remove partitionname. LVM will use a default.
  441.                 -l:drive     : set prefered driveletter for the volume
  442.                 -l:"" or -l- : remove driveletter for the volume (hide)
  443.                 -m    or -m- : set volume on the bootmanager menu, or remove it
  444.                 -i    or -i- : set installable status for volume,  or remove it
  445.                 -s           : force synchronization of start/size with p-tables
  446.  
  447.                 -D           : Force default values to be used, by deleting
  448.                                existing values before assigning new ones.
  449.                 -V           : Automatically assign a volume-name when new LVM
  450.                                info is created. This will make the partition a
  451.                                volume too, but without a drive-letter.
  452.                 -R           : Read-only, just show values (as used from LVMSHOW)
  453.  
  454.  
  455.                 -c           : Update CRC values for LVM sectors on all disks
  456.                 -d:nr        : disk number, restrict updates to this disk only
  457.                 -n:name      : new disk name for specified disk-nr
  458.  
  459.  
  460.  Output:        Confirmation and progress information, and when no -P- option
  461.                 is used, an LVM-update dialog window allowing change of most
  462.                 LVM values using entry-fields and check-boxes.
  463.  
  464.  Remarks:       When the -P- option is specified, the fields will be displayed
  465.                 only, from this display, the 'd' or <Enter> key will display
  466.                 the full LVM-information structure, and the 'x' key related
  467.                 partition-table. LVMSHOW will use this to diplay that sector.
  468.  
  469.                 When no LVM-info exists for the partition, it will be created
  470.                 automatically with a default value for the partition-name.
  471.                 With the -V option, a volume-name will be assigned as well.
  472.  
  473.                 The -d option will update the CRC values, usefull after manual
  474.                 editing of the LVM-info sectors, and in combination with the
  475.                 -n options it will update the descriptive LVM diskname.
  476.                 No other options can be used with -d or -c
  477.  
  478.                 Be carefull when updating a multi-partition volume (like JFS)
  479.                 the volumename and driveletter must be the same on all!
  480.  
  481.                 The command can be called directly from the operating system
  482.                 commandline, as in:
  483.  
  484.                         DFSOS2.EXE  -b  lvm  2  -v:System  -menu
  485.  
  486.                 This will place the 2nd partition on the BMGR menu as "System"
  487.  
  488.                 Unlike the "delete volume" operation in LVM itself, the "-v-"
  489.                 option in DFSee does NOT delete the partition as well. All the
  490.                 other LVM-info will remain intact, including the driveletter.
  491.                 A subsequent "-v:newname" will recreate the volume with a new
  492.                 name and use the same ("existing") partition and driveletter.
  493.  
  494.                 Note that YOU are responsible for keeping the driveletters
  495.                 unique for the whole system.
  496.  
  497.                 Using the "-p-" option deletes the explicit partition name,
  498.                 LVM will use a default name like "[ A3 ]" in this case.
  499.  
  500.  
  501.  
  502.  NEWMBR    [disk    [cleanpart]] = Refresh MBR bootcode, [clean] = delete all
  503.  
  504.  Purpose:       Create or refresh the boot-code in the master boot record
  505.  
  506.  Parameters:    disk    optional   Disk to operate on, default is all disks
  507.  
  508.                 clean   optional   Make the partition-table empty, effectively
  509.                                    deleting all existing partitions
  510.  
  511.  Output:        Progress information and confirmation messages
  512.  
  513.  Remarks:       none
  514.  
  515.  
  516.  NTSIGN    [disk    [signature]] = Set NT-signature in MBR, hex signature value
  517.  
  518.  Purpose:       Set a well-known value as NT disk-administrator signature
  519.  
  520.  Parameters:    disk    optional   Disk to operate on, default is all disks
  521.  
  522.                 sign    optional   The signature value, in hexadecimal format
  523.                                    Default value is hex DF5EE402
  524.  
  525.  Output:        Progress information and confirmation messages
  526.  
  527.  Remarks:       Setting a fixed value for the NT signature value in the MBR
  528.                 can avoid unwanted re-assigning of drive-letters when using
  529.                 Windows NT. It uses this value to correlate the drive-letter
  530.                 mapping kept in the registry. When cloning an NT image to a
  531.                 new disk, set the signature to the same (known) value.
  532.  
  533.  
  534.  NTMAP      [ verbose |  sync  ] = Show reg-diskkey, update & sync with DosDevice
  535.  
  536.  Purpose:       Show a table with disk-number, relative (registry) partition-nr
  537.                 the driveletter assigned, the size in Megabytes and the native
  538.                 NT device name related to the driveletter.
  539.  
  540.  Parameters:    verbose  optional  Expand table to multiple, detailed lines
  541.                                    for each listed driveletter
  542.  
  543.                 sync     optional  Synchronization request of the DFSee info
  544.                                    with NT registry, MBR signatures and the
  545.                                    dynamic driveletter assignments
  546.  
  547.                                    Note: automatically executed for "SETLET"
  548.                                          commands without a "ns" parameter
  549.  
  550.  Output:        Progress information
  551.  
  552.  Remarks:       The driveletters as shown by the DFSee "Part" table will be
  553.                 leading, and replace any existing values. Actions performed:
  554.  
  555.                 - When needed: NT signature in the MBR will be written
  556.                 - NT registry "disk" key will be (re)created
  557.                 - dynamic DosDevice mapping between WIN32 and native NT
  558.                   devicenames is updated when needed
  559.  
  560.  
  561.  NTDEV      [ device ] [mapping] = Show DosDevice mapping, wildcards limit output
  562.  
  563.  Purpose:       Show the mapping between WIN32 devices, including driveletters,
  564.                 and the underlying systemwide NT device-names
  565.  
  566.  Parameters:    device   optional  Wildcard specification for the WIN32 name
  567.                                    The default is "?:" resolving driveletters
  568.  
  569.                 mapping  optional  Wildcard specification for native NT name
  570.                                    The default is "*" for all devices
  571.                                    useful are: "*partition*"  for partitions
  572.                                                "*lanmanager*" for NET USE...
  573.  
  574.  Output:        A two column table with WIN32 versus NT native device names
  575.  
  576.  Remarks:       useful to check the assignment of driveletters to partitions
  577.                 on a disk, but also for network drives (aka NET USE ...)
  578.  
  579.  
  580.  DDD action WIN32dev [NT-device] = Direct manipulation of DosDevice mapping
  581.  
  582.  Purpose:       Low level corrections, test and debugging of DosDevice mapping
  583.                 (NOT intended for normal use)
  584.  
  585.  Parameters:    action   mandatory Flag value to be passed to DefineDosDevice
  586.                                    The default is 1  (RAW)
  587.  
  588.                                    Values:      DDD_RAW_TARGET_PATH         1
  589.                                                 DDD_REMOVE_DEFINITION       2
  590.                                                 DDD_EXACT_MATCH_ON_REMOVE   4
  591.                                                 DDD_NO_BROADCAST_SYSTEM     8
  592.  
  593.                 WIN32dev mandatory Specification for the WIN32 device, usually
  594.                                    this will be a driveletter (check NTDEV)
  595.  
  596.                 NT-dev   optional  Native NT device name (path) to define for
  597.                                    for the specified WIN32 devicename
  598.                                    When not specified, the mapping is deleted
  599.  
  600.  Output:        Success or failure status for the DefineDosDevice API call
  601.  
  602.  Examples:      DDD 1 R:                                Unassign R: mapping
  603.                 DDD 1 Q: \Device\Cdrom0                 Assign Q: to CDROM 1
  604.                 DDD 1 F: \Device\HardDisk0\Partition3   Assign F: to 3rd part
  605.                                                         on the first harddisk
  606.  
  607.  Remarks:       Only the (dynamic) mapping used by NT is updated, the registry
  608.                 key for driveletter mapping is not modified
  609.  
  610.  
  611.  CDR        CD-nr     letter | - = Set driveletter for CDrom (NT version only)
  612.  
  613.  Purpose:       Set or clear the driveletter for specified CDrom device
  614.  
  615.  Parameters:    CD-nr   mandatory  Sequence number for CDrom, first is 1
  616.  
  617.                 letter  mandatory  Driveletter to be used for the CDrom device
  618.                                    as displayed in the DFSee "NTMAP" command
  619.                                    Specify '-' to clear the driveletter
  620.  
  621.  Output:        Progress information and confirmation messages
  622.  
  623.  Remarks:       Only available in the WIN-NT version of DFSee
  624.  
  625.  
  626.  PCLEAR     disk [P][Lvm[S]][Br] = Clear info in P-tables, LVM and/or Boot-rec",
  627.  
  628.  Purpose:       Clear contents of partition-table, LVM or bootrecord sectors.
  629.                 The sectors will be completely filled with zero-bytes (0x00)
  630.  
  631.  Parameters:    disk    mandatory  Physical disknumber, or * for all disks
  632.  
  633.                 type       Ptable  Partition-table sectors (MBR and EBR's)
  634.                            Lvm     LVM disk/volume information sectors
  635.                              S     LVM signature sectors (only valid with'L')
  636.                            Bootrec Boot-records for each partition
  637.  
  638.                                    Only the first letter is required and
  639.                                    multiple types can be specified.
  640.  
  641.  Output:        Confirmation messages (interactive mode only)
  642.  
  643.  Remarks:       Confirmations (yes/no) will be issued for each physical disk
  644.                 when clearing partition-table and LVM-info sectors, and
  645.                 for each individual partition when clearing the boot-record.
  646.  
  647.  
  648.  PLIST     p|f|e|m|b|w|l [opts] = list: part|free|ebr|mbr|boot|walk|lvm
  649.  
  650.  Purpose:       Show one of several lists of partition related information
  651.  
  652.  Parameters:    type    optional   type of list wanted: p|f|e|m|b|w|l
  653.  
  654.                             part   normal partitions
  655.                             free   freespace area's
  656.                             ebr    EBR-chain
  657.                             mbr    MBR partition-table entries
  658.                             boot   Bootsectors for all partitions
  659.                             walk   MBR's and all EBR's (as WALK cmd)
  660.                             lvm    LVM volume information sectors and
  661.                                    the LVM signature sectors
  662.  
  663.  Options:       -d[:nr]     Disk to operate on, default is all disks when
  664.                             not specified and current disk for '-d'
  665.  
  666.                 -r          Related, include extra-info on related sectors
  667.                             (MBR/EBR versus LVM-info)
  668.  
  669.  Output:        The list of the requested type with info on start- and
  670.                 end-sector numbers, sizes and more.
  671.  
  672.  Remarks:       All sector-numbers are also stored in the DFS sector list,
  673.                 for use with the LIST and EXPORT commands.
  674.  
  675.  
  676.  PRESTORE *|disk Fname [types] = Write info from file into P-tables and LVM
  677.  
  678.  Purpose:       Restore (selected) partition-table, LVM and bootrecord
  679.                 sectors from a binary file created with the PSAVE command.
  680.  
  681.  Parameters:    disk    mandatory  Physical disknumber, or * for all disks
  682.  
  683.                 Fname   mandatory  Filename for file(s) to restore, when no
  684.                                    extension is specified, the 'disk' parameter
  685.                                    will be used to select the right .PDn file.
  686.                                    An explicit extension can be used to restore
  687.                                    from a different file (other disk number).
  688.  
  689.                 types   optional   Only restore sectors of specified type(s)
  690.  
  691.                                   r  = Master boot record
  692.                                   e  = Extended boot records
  693.                                   b  = Filesystem boot records
  694.                                   l  = LVM information sectors
  695.                                   s  = LVM signature   sectors
  696.  
  697.                 options:         -v  = verbose display and prompting
  698.                                  -l  = list sectors only (no write back)
  699.                                  -c- = no confirmation for each sector,
  700.                                        only for the complete .PDx file
  701.  
  702.  
  703.  Output:        Confirmation messages, depending on the specified options
  704.  
  705.  Remarks:       Sectors are not restored when the '-l' option is specified.
  706.  
  707.                 Quick restore with a single confirmation prompt for the
  708.                 whole file can be forced using the "-c-" option.
  709.  
  710.  
  711.  
  712.  PSAVE    *|disk Fname [comment] = Save Partition-table and LVM info in file
  713.  
  714.  Purpose:       Save contents of all partition-table, LVM and bootrecord
  715.                 sectors in one binary file per physical disk, selectively
  716.                 restorable with the associated PRESTORE command.
  717.  
  718.  Parameters:    disk    mandatory  Physical disknumber, or * for all disks
  719.  
  720.                 Fname   mandatory  Base filename for saved file(s), the
  721.                                    extension will be '.PDn' (n = disk nr)
  722.  
  723.                 comment optional   A text string that will be included in the
  724.                                    saved file(s) for easy identification.
  725.  
  726.  Output:        Progress info, one letter r, e, l or b for each saved sector
  727.  
  728.  Remarks:       Each resulting file will start with an ASCII header that
  729.                 contains info on the used DFSee version, date and time and
  730.                 some info on the disk and partitions. It also includes the
  731.                 comment specified on the PSAVE command.
  732.                 This info can be easily referenced by a simple TYPE of the
  733.                 file, the ASCII part ends in an EOF character (ctrl-Z) so
  734.                 the rest of the binary info does not mess up the display.
  735.  
  736.  
  737.  SETACCESS  pid [hide|vis|multi] = Make partition 'pid' accessible or hidden
  738.  
  739.  Purpose:       Set visibility for the specified partition.
  740.  
  741.  Parameters:    pid     mandatory  Partition id, see PART and MAP display
  742.  
  743.                 hide    optional   Make this partition hidden (invisible)
  744.                 vis     optional   Make this partition visible, hide others
  745.                 multi   optional   Make this partition visible, but do allow
  746.                                    multiple visible primary partitions per disk
  747.  
  748.  Output:        Progress information and confirmation messages
  749.  
  750.  Remarks:       The partition will be made visible (types 01 .. 0f).
  751.                 All other primaries on the same disk will be made hidden,
  752.                 except when the 'multi' parameter was given.
  753.  
  754.  
  755.  SETBOOT    [/]opt[:params]      = Bootmanager setup and reboot options
  756.  
  757.  Purpose:       Configure BMGR; Set partition to boot, and (optional) boot
  758.  
  759.  Parameters:    opt     mandatory  Option letter/word for the setboot action
  760.  
  761.                 params  optional   Depending on the selected option:
  762.  
  763.                       q:disk       (query BM settings on 'disk')
  764.                       t:timeout    (seconds or NO)
  765.                       m:mode       (normal or advanced)
  766.                       x:num        (set system-index to 'num')
  767.                  [0..5]:name       (set system 0..5 to 'name')
  768.                     ibd:d          (reboot from drive d)
  769.                     iba:BM-name    (reboot from BM-name)
  770.                       n:d          (set next-boot to drive d)
  771.                       a:BM-name    (set next-boot to BM-name)
  772.                       b            ([shutdown] and reboot now)
  773.  
  774.  
  775.       System-indexes 0..5 have the following meaning:
  776.  
  777.       0  default system,  Booted when no other selection is made from the
  778.                           menu, or when the timeout is set to NO.
  779.  
  780.    1..3  fallback range   On a failing boot on one of these systems, the
  781.                           next boot will be of the next lower-number
  782.                           system (fallback scenario)
  783.  
  784.       4  force-reboot     Indicates the system-name to boot next time,
  785.                           without display of the menu (forced).
  786.                           This is used by the /iba:name option.
  787.                           The name is automatically cleared on the next boot.
  788.  
  789.       5  last-booted      The system-name last booted using bootmanager.
  790.                           This will also be the default when the default
  791.                           system itself (0) is not set.
  792.  
  793.  Output:        Progress information and confirmation messages
  794.  
  795.  Remarks:       Both the 'classic' version of IBM bootmanager (2.1 upto Warp-4)
  796.                 and the "Warp-server-for-e-business" or "eComStation" version
  797.                 working together with LVM are supported. The latter uses
  798.                 longer names for the partitions that are bootable.
  799.  
  800.                 - The reboot from DFSOS2.EXE requires DOS.SYS to be loaded!
  801.                 - The reboot from DFSDOS will only work on Win9x when the
  802.                   external reboot program 'dfsdosx.exe' is present.
  803.  
  804.  
  805.  SETLET     pid  letter | - [ns] = Set driveletter for DFSee; [ns] = no sync
  806.  
  807.  Purpose:       Set or clear the driveletter for a partition
  808.  
  809.  Parameters:    pid     mandatory  Partition id, see PART and MAP display
  810.  
  811.                 letter  mandatory  Driveletter to be used with the partition
  812.                                    as displayed in the DFSee tables
  813.                                    Specify '-' to clear the driveletter
  814.  
  815.                 ns      optional   No Synchronize with NT registry and the
  816.                                    dynamic NT drive-letter assignment
  817.                                    Otherwise a complete sync between DFSee
  818.                                    and the registry will be done, comparable
  819.                                    with the "NTMAP sync" command.
  820.  
  821.  
  822.  Output:        Progress information and confirmation messages
  823.  
  824.  Remarks:       Setting the driveletter as used in DFSee tables works for all
  825.                 versions. However, the real use is with the NT version where
  826.                 the driveletter as used by NT itself will change too!
  827.                 It will be updated in the "Disk" key in the registry and in
  828.                 the dynamically maintained DosDevice mapping
  829.  
  830.                 It might be wise to reboot or shutdown quickly after changing
  831.                 critical drive-letters like the WINNT system or boot drive.
  832.  
  833.                 To change driveletters and other related info for systems
  834.                 with LVM (OS/2 4.5, eComStation) use the LVMSET command.
  835.  
  836.  
  837.  SETNAME    pid        [BM-name] = Set or reset bootmanager name for partition
  838.  
  839.  Purpose:       Set or clear the name for a partition, adding it to the menu
  840.  
  841.  Parameters:    pid     mandatory  Partition id, see PART and MAP display
  842.  
  843.                 BM-name optional   When specified, this is the name to be
  844.                                    used in the bootmanager menu. (length 8)
  845.  
  846.                                    When not specified, the partition will
  847.                                    be removed from the menu by clearing the
  848.                                    name in the bootmanager administration.
  849.  
  850.  Output:        Progress information and confirmation messages
  851.  
  852.  Remarks:       To change the volumename and other related info for systems
  853.                 with LVM (OS/2 4.5, eComStation) use the LVMSET command.
  854.  
  855.  
  856.  SETTYPE    pid  disk new  [old] = Change partition-type from old to new
  857.  
  858.  Purpose:       Change the system-type for a partition to a new value
  859.  
  860.  Parameters:    pid     mandatory  Partition id, see PART and MAP display
  861.  
  862.                 disk    Disknr, * or 0, used for selection verification
  863.  
  864.                 new     mandatory  New system-type, hexadecimal or symbolic
  865.  
  866.                         The most used system-types are:
  867.  
  868.                         hex   sym
  869.  
  870.                         01   FAT12  =  FAT12
  871.                         04   FAT16  =  FAT16 < 32 Mb
  872.                         05   EXT    =  Extended partition (chain)
  873.                         06   FAT    =  FAT16 > 32 Mb
  874.                         07   IFS    =  Installable File system
  875.                         07   HPFS   =  IFS, HPFS (alias)
  876.                         07   NTFS   =  IFS, NTFS (alias)
  877.                         0a   BMGR   =  OS/2 Bootmanager
  878.                         0b   FAT32  =  FAT32 small and below cyl 1024
  879.                         0c   FAT32X =  FAT32 large or beyond cyl 1024
  880.                         0f   BIGX   =  Large extended (PQMAGIC 4.0)
  881.                         82   SWAP   =  Linux swap partition
  882.                         83   EXT2   =  Linux EXT2 data partition
  883.                         eb   BEOS   =  BeOS filesystem
  884.                         fe   PS2S   =  PS/2 system partition
  885.  
  886.                 old     optional   Existing system-type, for verification
  887.  
  888.                 Options:     -e    Force setting an extended type 0x05 or 0x0f
  889.  
  890.  
  891.  Output:        Progress information and confirmation messages
  892.  
  893.  Remarks:       Only the type of the partition in the partition-table will
  894.                 be changed. The actual internal format of the partition is
  895.                 not affected by this operation.
  896.  
  897.                 You can get an overview of all types with the 'TYPE' command.
  898.  
  899.  
  900.  
  901.  STARTABLE  pid  [multi | clear] = Make partition 'pid' startable (bootable)
  902.  
  903.  Purpose:       Make the selection partition the 'active' one to be booted
  904.  
  905.  Parameters:    pid     mandatory  Partition id, see PART and MAP display
  906.  
  907.                 multi   optional   Allow multiple primary partitions per disk
  908.                 clear   optional   Clear the 'active' flag to 'not-startable'
  909.  
  910.  Output:        Progress information and confirmation messages
  911.  
  912.  Remarks:       The partition status will be set to 'active' (0x80) and,
  913.                 if needed the partition will be made visible.
  914.                 All other primaries on the same disk will be made hidden,
  915.                 except when the 'multi' parameter was given.
  916.                 When 'clear' is specified, the active bit will be reset (0x00)
  917.                 and no change in visibility for any partition will be made.
  918.  
  919.  
  920.  TYPE       [system-type       ] = Show system-type description (for 00..ff)
  921.  
  922.  Purpose:       Show short description for one, or all known system types
  923.  
  924.  Parameters:    type    optional   one system type to query
  925.  
  926.  Output:        Single line when one type queries, or 4 descriptions per
  927.                 line covering all known system-types from 00 through ff
  928.  
  929.  Remarks:       none
  930.  
  931.  
  932.  VCU        disk  | * |  -d[:nr] = Clear existing LVM-info, create new defaults
  933.  
  934.  Purpose:       Create new LVM information like volume- and partition-names
  935.                 Remove current LVM information when present.
  936.  
  937.  Parameters:    disk | *           Disk number or '*' for all disks
  938.  
  939.  Options        -d[:nr]            Disk number, or current disk
  940.  
  941.  Output:        Progress information
  942.  
  943.  Remarks:       This can be used to create default LVM-information with
  944.                 names derived from partition-id, filesystem-types and size
  945.                 and assign the drive-letters as currently known to DFSee.
  946.                 The default volumenames will be taken from the current
  947.                 bootmanager names or the drive LABEL when available.
  948.  
  949.                 LVM additional information in the signature sectors, as used
  950.                 by LVM/JFS partitions (type 0x35) will not be cleared, so it
  951.                 is safe to use this command on a system with JFS partitions.
  952.  
  953.  
  954.  VIRTUAL     Fname | size [H S] = Virtual disk from CURRENT, Fname or size/geo
  955.  
  956.  Purpose:       Show short description for one, or all known system types
  957.  
  958.  Parameters:    layout  optional   Disk size and geometry, in several forms:
  959.  
  960.                   none     = Disk with same size and geometry as current
  961.  
  962.                   Fname    = Disk with size and geometry as in the *.PD*
  963.                              file specified, created with the PSAVE cmd.
  964.                              The file will be automatically restored on
  965.                              the newly created virtual disk (PRESTORE).
  966.                              This leads to a virtual disk with exactly
  967.                              the same partitions as the original disk.
  968.  
  969.                   size[[,d|x]m|g|c|s]  Specific size value, hex or decimal.
  970.                                        in Mb, Gb, Cylinders or Sectors.
  971.                                        Default: decimal Megabytes
  972.  
  973.                   H S      = Heads & Sectors to use with specified size
  974.  
  975.  Options:         -o    Open the created virtual-disk, showing disk-geometry
  976.                         This will allow direct use from scripts, without
  977.                         knowing the actual disk number.
  978.  
  979.  Output:        Single line specified the virtual and real disk-number
  980.  
  981.  Remarks:       The virtual disk created will be empty at start (zeroes)
  982.                 Only sectors written to will actualy be created in memory,
  983.                 this might be limitted by the available memory.
  984.  
  985.                 A virtual disk is very usefull when experimenting, an existing
  986.                 partition-scheme can be copied by using PSAVE and PRESTORE.
  987.  
  988.  
  989.  VREMOVE                   [ * ] = Remove last one made, or all virtual disks
  990.  
  991.  Purpose:       Remove virtual disk(s) from memory, freeing up resources
  992.  
  993.  Parameters:    *       optional   remove all existing virtual disks
  994.  
  995.  Output:        none
  996.  
  997.  Remarks:       There is usualy no need to remove virtual disks, they
  998.                 automatically disappear when DFSee ends
  999.  
  1000.  
  1001.  VSTATUS                         = Show R/W and usage status of virtual disks
  1002.  
  1003.  Purpose:       Show nr of sectors in use and read/write statistics for virtuals
  1004.  
  1005.  Parameters:    none
  1006.  
  1007.  Output:        A few lines with statistics for every virtual disk
  1008.  
  1009.  
  1010.  
  1011.  W2KBM     [disk               ] = Make IBM's bootmanager Windows-2000 proof
  1012.  
  1013.  Purpose:       Make bootmanager sectors survive a Win-2000 CHKDSK operation
  1014.  
  1015.  Parameters:    disk    optional   Nr of the disk containing bootmanager
  1016.  
  1017.  Output:        Prompting, progress and confirmation information.
  1018.  
  1019.  Remarks:       The method used is based on a C't article and uses the
  1020.                 FAT bootsector field 'reserved sectors to 1st FAT' to
  1021.                 protect the BMGR data area
  1022.  
  1023.                 Some additional changes are inspired by Daniela Engert and
  1024.                 avoid the nasty CHKDSK screen while booting W2K (ver 3.36)
  1025.  
  1026.                 Another (not DFSee related) thing you might do to avoid
  1027.                 any conflicts is to hide your HPFS volumes for WIN2000.
  1028.                 If you don't you will sometimes be prompted with the
  1029.                 frightning: "Volume is not formatted, format it now?"
  1030.                 If you reply with "YES" you just lost your HPFS partition!
  1031.  
  1032.                 To hide a volume from normal WIN2000 programs like explorer:
  1033.  
  1034.                 Start
  1035.                   Settings
  1036.                     Control Panel
  1037.                       Administration Tools
  1038.                         Computer Management
  1039.                           Disk Management
  1040.  
  1041.                             Now select the HPFS partition from the list,
  1042.                             based on drive-letter and/or partition size.
  1043.                             Use right mouse button to get the contect-menu
  1044.  
  1045.                               Change Driveletter and paths ...
  1046.  
  1047.                               Now click the [remove]  button
  1048.  
  1049.                 This will only remove the DRIVE-LETTER association for that
  1050.                 partition in WIN2000, the partition itself is not touched!
  1051.  
  1052.  
  1053.  WALK       [disk]           [!] = Select disk and walk MBR/EBR chain, reset
  1054.  
  1055.  Purpose:       Show all partitioning information for the specified disk
  1056.  
  1057.  Parameters:    dsknr   optional   disk nr, default is current if open or 1
  1058.                 !       optional   reset previously forced geometry
  1059.  
  1060.  Output:        Disk Geometry, MBR and all linked EBR's in partition format
  1061.  
  1062.  Remarks:       The dfs_number variable for REXX will be set to nr-of-disks
  1063.                 See also: DISK command (dfscmds.txt)
  1064.