Инструменты пользователя

Инструменты сайта


openmsx:msxtar

Это старая версия документа!


msxtar

Консольная программа для работы с образами дисков MSX. Copyright (C) 2004 David Heremans

Для работы с сжатыми образами программа использует gzip и bzip2

Такие образы используются в:

Поддерживаются форматы:

  • single-sided
  • double-sized
  • образы дисков IDE (только FAT12)

msxtar

Архив репозитория

Установка

Компиляция и установка:

msxtar,sh
#!/bin/bash
 
sudo make
sudo cp msxtar /usr/local/bin
sudo chmod a+xr-w /usr/local/bin/msxtar

Параметры командной строки

msxtar [ПАПАМЕТР(Ы)]… [ФАЙЛ(Ы)]…

Примеры:

  • Создать образ диска, взяв файлы/папки из foo и bar
    msxtar -cf disk.dsk foo bar
  • Получить подробный список всех файлов disk.dsk
    msxtar -tvf disk.dsk
  • Извлечь все файлы из disk.dsk
    msxtar -xf disk.dsk

Основной режим работы:

-t, –listполучить список файлов образа диска
-x, –extract, –getизвлечь все файлы из образа диска
-c, –createсоздать новый образ диска
-r, –appendдобавлять файлы в конец образа диска
-u, –updateдобавлять только файлы новее, чем те которые есть в образе диска
-A, –catenate, –concatenateдобавить файлы в образ диска

Обработка атрибутов файла:

–owner=ИМЯпринудительно использовать ИМЯ в качестве владельца для добавляемых файлов
–group=ИМЯпринудительно использовать ИМЯ как группу для добавляемых файлов
–mode=CHANGESпринудительный (символьный) режим CHANGES для добавленных файлов
-k, –keepсохранить существующие файлы, не перезаписывать их
-m, –modification-timeне извлекать время изменения файла

Параметры образов:

-f, –file=ФАЙЛиспользовать ФАЙЛ как имя файла образа или как имя устройства, по умолчанию имя файла: msxdiskimage.dsk
-S, –size=РАЗМЕР

РАЗМЕР может быть задан в виде nnnn[S|B|K|M]
также предопределены следующие значения:

  • single — 360 КБ
  • double — 720 КБ
  • ide — 32 МБ
-1, –dos1использовать загрузочный сектор MSX-DOS 1, нет поддержки папок
-2, –dos2использовать загрузочный сектор MSX-DOS 2, можно использовать папки
-M, –msxdir=ИМЯ_ПАПКИ_В_ОБРАЗЕиспользовать для новых файлов выбранную папку в образе
-P, –partition=РАЗДЕЛиспользовать выбранный РАЗДЕЛ при работе, можно задать значение all для обработки всех разделов

Вывод информации:

–helpвывести справочную информацию и завершить программу
–versionвывести версию программы и завершить программу
-v, –verboseвыводить подробную информацию о обработанных файлах

Примеры

Варианты работы:

Для лучшего понимания прочтите маленькую описание в начале каждого раздела.

Простые образы дискет

Чтобы указать имя файла образа диска используйте параметр -f, иначе будет использоваться имя по умолчанию: msxdiskimage.dsk

Получить список файлов образа диска:

msxtar -tf <ИМЯ_ФАЙЛА_ОБРАЗА>

Извлечь все файлы из образа диска (в текущую папку):

msxtar -xf <ИМЯ_ФАЙЛА_ОБРАЗА>

Создать образ диска:

msxtar -cvf <ИМЯ_ФАЙЛА_ОБРАЗА> <СПИСОК_ФАЙЛОВ ИЛИ ПАПКА_С_ФАЙЛАМИ>

Создать образ диска с указанием его размера (single или double):

msxtar -cvf <ИМЯ_ФАЙЛА_ОБРАЗА> --size=<РАЗМЕР> <СПИСОК_ФАЙЛОВ ИЛИ ПАПКА_С_ФАЙЛАМИ>

Добавление файлов (будут добавлены только те файлы, которых еще нет в образе):

msxtar -Avf <ИМЯ_ФАЙЛА_ОБРАЗА> <СПИСОК_ФАЙЛОВ ИЛИ ПАПКА_С_ФАЙЛАМИ>

Обновление файлов (существующие файлы будут заменены новыми, отсутствующие файлы будут добавлены):

msxtar -uvf <ИМЯ_ФАЙЛА_ОБРАЗА> <СПИСОК_ФАЙЛОВ ИЛИ ПАПКА_С_ФАЙЛАМИ>

Образы дискет с папками

По умолчанию программа работает с корнем диска.

Для отключения режима работы с папкам нужно использовать параметр –dos1
Если вы это сделаете, будет создан новый образ диска, загрузочный сектор также будет содержать загрузочный блок MSX-DOS 1!

Чтобы обновить файлы с папке нужно указать её имя на ПК и в образе, для этого нужно использовать параметр –msxdir

msxtar -uvf <ИМЯ_ФАЙЛА_ОБРАЗА> --msxdir=<ИМЯ_ПАПКИ_В_ОБРАЗЕ> <ИМЯ_ПАПКИ_НА_ПК>

Чтобы извлечь только определенную папку из образа нужно использовать следующую команду:

msxtar -xvf <ИМЯ_ФАЙЛА_ОБРАЗА> --msxdir=<ИМЯ_ПАПКИ_В_ОБРАЗЕ>

Образы дисков IDE

FIXME

msxtar has to possibilty to manage files on an HD image meant for the MSX-IDE-bios from H.Gilvad and Jon Deschrijder. These images are recognised by a string written by IDEFDISK in the first sector of the HD.

Q3.1: How do I create a new HD-image?
      How do I alter/add/delete partitions on an HD image?
A: This isn't supported by the current version of msxtar.
   For this kind of operations use IDEFDISK.COM in the emulated MSX.
   For more info see the openMSX manual, and the IDEFDISK.TXT file.

Q3.2: How can I extract all files on the HD image at once
A: You can extract all files at once by using the command
	msxtar -xvf <diskimage-name> --partition=all <subdir name on host>
   Each partition will be extract into a seperate subdirectory

Q3.3: Can I add/udpate files/directories to existing partitions
A: Yes, proceed as with simple diskimage but add the need '--partition' option
   to indicate the partion you want to alter. 

Note: the --partition=all only works when extracting or listing the files. Also
the option '--msxdir' is ignored in such case!

Ссылки

openmsx/msxtar.1599993720.txt.gz · Последние изменения: 2020-09-13 13:42 — GreyWolf