last update: 6.4.2012<\/p>\n
The rdbtool is a tool from the amitools tool set that allows to inspect or create hard disk partitions readable by the classic Amiga family of computers. The RDB or Rigid Disk Block is a format to describe the first blocks of a hard disk that store information of partitions and file systems used in the partitions.<\/p>\n
If you want to work with files stored in the DOS file system of a partition then have a look at the xdftool<\/a> of amitools.<\/p>\n rdbtool is a command line utility that is always called with an hard disk image file path name as the first argument and with one or more commands working on this image:<\/p>\n You can issue multiple commands on a single image by concatenating them with a plus character:<\/p>\n For example:<\/p>\n Most options in rdbtool are given as key=value pairs. Here the option “size” is given with value “10Mi” for a 10 MiB sized disk image.<\/p>\n Real Block Devices<\/strong><\/p>\n On Unix\/Linux\/Mac OS X you can also use a block device of a real hard disk or a CF\/SD flash card to directly work on a real device. The file names for the block device differ on the different platforms but typical names are \/dev\/rdisk1<\/em> or \/dev\/sda<\/em>. Always make sure to select the block device of the whole drive (e.g. \/dev\/hdc<\/em>) and not the device of some already existing\u00c2\u00a0 paritioning (e.g. \/dev\/hdc1<\/em>). Also make sure (really, really sure!) <\/strong>to select the correct block device of the hard disk you want to alter with rdbtool. Otherwise you might destroy your actual system disk!!!<\/strong> Most OSes need a priviliged user to perform these operations so you need to run rdbtool as root in this case.<\/p>\n This section describes the commands available for rdbtool. You can always issue a “help” command to see all commands:<\/p>\n In rdbtool there are two ways to access an image: open or create it. The “open” operation assumes that the disk image file already exists or is used for existing devices available through block device names.<\/p>\n SYNTAX<\/strong><\/p>\n DESCRIPTION<\/strong><\/p>\n The “create” operation is used to create a new image file. The create command needs a size parameter:<\/p>\n You can either specify the total size in bytes (or here with unis M=mega Mi=Ki-Units) and let rdbtool choose a suitable disk geometry automatically or you can give the geometry with:<\/p>\n Here 10 cylinders, 1 head and 32 sectors are defined.<\/p>\n You can only use the “create” command if the given image file does not exist yet. If it already exists then an error message is generated. However, you can force the creation of the image file by giving the “-f” switch for force:<\/p>\n SYNTAX<\/strong><\/p>\n DESCRIPTION<\/strong><\/p>\n The open operation usually does not need any paramters:<\/p>\n You can even omit the “open” command in this case:<\/p>\n This will implicitly open the image first.<\/p>\n If no option is given then the disk geometry is automatically determined from the image size. If this does not work for an image you can also specify the geometry of the image in the open command:<\/p>\n You can also only hint the geometry by giving some geometry paramters and let rdbtool guess the others:<\/p>\n SYNTAX<\/strong><\/p>\n DESCRIPTION<\/strong><\/p>\n This command gives an overview of the partitions and file systems stored in the RDB blocks. It will return something like:<\/p>\n SYNTAX<\/strong><\/p>\n show<\/p>\n DESCRIPTION<\/strong><\/p>\n This command is a low-level tool that shows the blocks available in the RDB data structure with their corresponding values. Use this to debug or analyze issues with complex RDBs.<\/p>\n SYNTAX<\/strong><\/p>\n DESCRIPTION<\/strong><\/p>\n This command creates a new and initially empty RDB structure. Any existing partitioning layout will be lost after executing this command! So you have been warned!<\/strong> Call this command first to start building a new RDB structure.<\/p>\n The default RDB occupies all the sectors of the first cylinder. If you have chosen a geometry with small cylinders then a single cylinder might not be sufficient to hold the RDB data structures. In this case use the “rdb_cyls” option to set the number of cylinders to reserve for RDB:<\/p>\n SYNTAX<\/strong><\/p>\n DESCRIPTION<\/strong><\/p>\n This command creates a new partition.<\/p>\n You have to give the size of the partition in one of the following ways:<\/p>\n 1. Give start and end cylinder:<\/p>\n 2. Give start cylinder and size:<\/p>\n 3. Only give size:<\/p>\n For the size you can specify a number of cylinders, a percent value, or a byte size (The percent value gives the ratio of the total logical disk size):<\/p>\n If no “name” option is given then the defaul name “DH” is used appended with the current partition number starting with 0: DH0, DH1. You can alter the base name by giving the “-p” switch (for drive prefix):<\/p>\n The “dostype” or “fs” switch can be used to select the file system you will use to format the partition. The default is “DOS3”, i.e. Fast Filing System with International Support. You can give the dostype with “DOS<n>” or as a hex number 0x44556677 or for standard DOS file systems with “ofs”, “ffs” and append “dc” or “dircache” or “intl” flags:<\/p>\n You can make a partition bootable by setting the “bootable” flag. Additionally you can select the boot priority with “pri=<n>”:<\/p>\n SYNTAX<\/strong><\/p>\n DESCRIPTION<\/strong><\/p>\n The <id> is the number of the paritition as given in the ‘info’ command. You can also use the device name to select a parition.<\/p>\n SYNTAX<\/strong><\/p>\n DESCRIPTION<\/strong><\/p>\n This command returns one or more cylinder ranges that are currently not occupied by partitions. You can use this command to find out the range for a new partition.<\/p>\n If the current partition layout aready occupies the whole disk then this command will return nothing.<\/p>\n SYNTAX<\/strong><\/p>\n DESCRIPTION<\/strong><\/p>\n This command takes the free space in a partition layout and creates a newpartition that fills this space.<\/p>\n This command supports the same options as used in the ‘add’ command above.<\/p>\n If multiple holes are in the current partition layout then this command creates a new partition for each existing hole.<\/p>\n With this command you can easily finish paritioning without the need of calculating the size of the final partition:<\/p>\n SYNTAX<\/strong><\/p>\n <\/p>\n DESCRIPTION<\/strong><\/p>\n This command removes an existing partition and frees all associated resources.<\/p>\n The <id> is the number of the paritition as given in the ‘info’ command. You can also use the device name to select a parition.<\/p>\n SYNTAX<\/strong><\/p>\n DESCRIPTION<\/strong><\/p>\n This command lets you look under the hood of the RDB. It will print all blocks associated with the RDB and shows their current contents. A two char code is used for each block:<\/p>\n The RDB data structure allows to store file system drivers for classic AmigaOS, so the Kickstart can load the driver before mounting a parition in the RDB.<\/p>\n File systems are LoadSeg()able Amiga Hunk binaries directly embedded in the RDB blocks.<\/p>\n Use the “info” command to see if any file systems are already stored in the RDB. In the output you can see that the file systems are numbered in rdbtool starting with 0.<\/p>\n SYNTAX<\/strong><\/p>\n DESCRIPTION<\/strong><\/p>\n This command extracts the file system numbered <id> and stores the LoadSeg()able Amiga binary on your local system into a new file with the given <filename>:<\/p>\n SYNTAX<\/strong><\/p>\n DESCRIPTION<\/strong><\/p>\n Add the LoadSeg()able file system driver stored in file <filename> to the current RDB.<\/p>\n Every file system driver needs a version information given as <x>.<y>, e.g. 40.63. When a file is loaded the version is automatically extracted from a “VER:” tag inside the binary. If this tag cannot be found you can specify the version with the “version” option.<\/p>\n SYNTAX<\/strong><\/p>\n DESCRIPTION<\/strong><\/p>\n With this command you can alter the device node flags of a file system.<\/p>\n The file system <id> is the number of the file system as listed with the ‘info’ command.<\/p>\n The following keys are supported:<\/p>\n The “clear” option will remove all flags first. All other commands add the corresponding flag:<\/p>\n Have a look at the output of the ‘info’ command to see the flags set for a file system.<\/p>\n SYNTAX<\/strong><\/p>\n DESCRIPTION<\/strong><\/p>\n The file system with the given number is removed. All associated blocks of the file system are free’d.<\/p>\n EOF<\/p>\n","protected":false},"excerpt":{"rendered":" rdbtool – The universal Amiga disk partitioning tool last update: 6.4.2012 1. Introduction The rdbtool is a tool from the amitools tool set that allows to inspect or create hard disk partitions readable by the classic Amiga family of computers. … Continue reading 2. Usage<\/h4>\n
> rdbtool <image.rdb|image.rdisk> <command> [option]<\/pre>\n
> rdbtool <image.rdb> <command1> [options1] + <command2> [options2] ...<\/pre>\n
> rdbtool myimg.rdb create size=10Mi + init + fill<\/pre>\n
3. Commands<\/h4>\n
> rdbtool test.img help<\/pre>\n
3.1 Open\/Create an Image<\/h4>\n
‘create’ – Create a new disk image<\/h5>\n
create [ size=<size> | chs=<cyl>,<heads>,<secs> ]<\/pre>\n
> rdbtool test.img create size=10Mi<\/pre>\n
> rdbtool test.img create chs=10,1,32<\/pre>\n
> rdbtool -f test.img create chs=10,1,32\r\n<\/pre>\n
‘open’ – Open existing image for processing<\/h5>\n
open [ chs=<cyl>,<heads>,<secs> | c=<cyl> h=<heads> s=<secs> ]<\/pre>\n
> rdbtool test.img open + info<\/pre>\n
> rdbtool test.img info<\/pre>\n
> rdbtool test.img open chs=10,1,32<\/pre>\n
> rdbtool test.img open c=10 h=2 s=32\r\n<\/pre>\n
3.2 Inspect the Partition Layout<\/h4>\n
‘info’ – Show information of the RDB data structures<\/h5>\n
info<\/pre>\n
PhysicalDisk:\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 7817\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 7880544\u00c2\u00a0 3.8Gi\u00c2\u00a0 heads=16 sectors=63\r\nLogicalDisk:\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 2\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 7817\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 7878528\u00c2\u00a0 3.8Gi\u00c2\u00a0 rdb_blks=[0:2015,60(60)] cyl_blks=1008\r\nPartition: #0 'CDH0'\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 2\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 103\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 102816\u00c2\u00a0\u00c2\u00a0 50Mi\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 1.31%\u00c2\u00a0 DOS3 bootable pri=0\r\nPartition: #1 'DH0'\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 104\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 205\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 102816\u00c2\u00a0\u00c2\u00a0 50Mi\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 1.31%\u00c2\u00a0 DOS3\r\nPartition: #2 'DH1'\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 206\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 2035\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 1844640\u00c2\u00a0 900Mi\u00c2\u00a0\u00c2\u00a0 23.41%\u00c2\u00a0 DOS3\r\nPartition: #3 'DH2'\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 2036\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 3763\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 1741824\u00c2\u00a0 850Mi\u00c2\u00a0\u00c2\u00a0 22.11%\u00c2\u00a0 DOS3\r\nPartition: #4 'DH3'\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 3764\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 3909\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 147168\u00c2\u00a0\u00c2\u00a0 71Mi\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 1.87%\u00c2\u00a0 DOS3\r\nPartition: #5 'CDH1'\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 3910\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 3971\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 62496\u00c2\u00a0\u00c2\u00a0 30Mi\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 0.79%\u00c2\u00a0 DOS3\r\nPartition: #6 'DH4'\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 3972\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 4124\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 154224\u00c2\u00a0\u00c2\u00a0 75Mi\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 1.96%\u00c2\u00a0 DOS3\r\nPartition: #7 'DH5'\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 4125\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 5953\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 1843632\u00c2\u00a0 900Mi\u00c2\u00a0\u00c2\u00a0 23.40%\u00c2\u00a0 DOS3\r\nPartition: #8 'DH6'\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 5954\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 7817\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 1878912\u00c2\u00a0 917Mi\u00c2\u00a0\u00c2\u00a0 23.85%\u00c2\u00a0 DOS3\r\nFileSystem #0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 DOS1 version=40.1 size=24588<\/pre>\n
‘show’ – Show internal block representation of the RDB data structures<\/h5>\n
3.3 Create a new RDB<\/h4>\n
‘init’ – Create a new and empty RDB structure<\/h5>\n
init [ rdb_cyls=<cyls> ]<\/pre>\n
> rdbtool test.img create size=10Mi + init<\/pre>\n
> rdbtool test.img create size=10Mi + init rdb_cyls=2<\/pre>\n
‘add’ – Add a new partition<\/h5>\n
add\u00c2\u00a0 <size> [ name=<name> ] [ dostype|fs=<dostag> ] \r\n [ bootable[=true|false] ] [ pri=<priority> ]\r\n [ automount=true|false ]<\/pre>\n
start=<cyl> end=<cyl><\/pre>\n
start=<cyl> size=<cyl|percent|bytes><\/pre>\n
size=<cyl|percent|bytes><\/pre>\n
> rdbtool test.img add start=2 end=5\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 ; give start and end cylinder\r\n> rdbtool test.img add start=4 size=10\u00c2\u00a0 ; give start and number of cylinders\r\n> rdbtool test.img add size=10MiB\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 ; give size in bytes\r\n> rdbtool test.img add size=50%\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 ; use half the disk size<\/pre>\n
> rdbtool -p CH test.img init + add size=10%\u00c2\u00a0\u00c2\u00a0 ; create partition CH0<\/pre>\n
... dostype=DOS0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 ; OFS\r\n... dostype=ofs+dc\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 ; OFS + dircache\r\n... dostype=ffs+intl\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 ; FFS + international mode\r\n... dostype=0x44556677\u00c2\u00a0 ; give hex of dostype<\/pre>\n
> rdbtool test.img add size=10% bootable pri=10<\/pre>\n
‘change’ – Modify parameters of an existing partition<\/h5>\n
change <id>\u00c2\u00a0 [ name=<name> ] [ dostype|fs=<dostag> ] \r\n [ bootable[=true|false] ] [ pri=<priority> ]\r\n [ automount=true|false ]\r\n<\/pre>\n
> rdbtool test.img change 0 name=CH0 bootable=true<\/pre>\n
‘free’ – Show free cylinder range in partition layout<\/h4>\n
free\r\n<\/pre>\n
‘fill’ – Fill the remaining space in the partition layout with new partition(s)<\/h5>\n
fill \r\n<\/pre>\n
> rdbtool test.img init + add size=50% + fill\u00c2\u00a0\u00c2\u00a0 ; create 2 partitions with 50% size each\r\n> rdbtool test.img init + add size=10% + add size=20% + fill<\/pre>\n
‘delete’ – Delete an existing partition <\/strong><\/h5>\n
delete\u00c2\u00a0 <id>\r\n<\/pre>\n
> rdbtool mydisk.rdb delete 0\r\n> rdbtool mydisk.rdb delete dh1<\/pre>\n
‘map’ – Show the allocation map of the RDB blocks<\/h5>\n
map<\/pre>\n
--\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 block is empty and not used for RDB\r\n RD\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 the main rigid disk block\r\n P?\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 partition <n>\r\n F?\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 file system <n><\/pre>\n
> rdbtool mydisk.rdb map\r\n<\/pre>\n
3.4 Working with File Systems<\/h4>\n
‘fsget’ – Retrieve the file system driver from a RDB structure<\/h5>\n
fsget\u00c2\u00a0 <id> <filename>\r\n<\/pre>\n
> rdbtool mydisk.rdb fsget 0 ffs\u00c2\u00a0\u00c2\u00a0 ; create a new file \"ffs\" with the first driver<\/pre>\n
‘fsadd’ – Add a new file system driver<\/h5>\n
fsadd\u00c2\u00a0 <filename>\u00c2\u00a0 [version=<x.y>]<\/pre>\n
> rdbtool mydisk.rdb fsadd ffs version=60.32<\/pre>\n
‘fsflags’ – Change flags of file system<\/h5>\n
fsflags\u00c2\u00a0 <id>\u00c2\u00a0 [ clear | key=value ... ]<\/pre>\n
type\r\n task\r\n lock\r\n handler\r\n stack_size\r\n priority\r\n startup\r\n seg_list_blk\r\n global_vec<\/pre>\n
> rdbtool mydisk.rdb fsflags 0 clear stack_size=8192<\/pre>\n
‘fsdelete’ – Remove a file system<\/h5>\n
fsdelete <id><\/pre>\n