---

mcd

mcd опции* конфигурационный_файл &

Neutrino

ARM, PowerPC, SH, x86

-D

-E

-I

-n

-v

-V

конфигурационный_файл

• Обзор утилиты mcd

• Правила MCD

• Сервер MCD

• Последовательность операций

• Конфигурирование MCD

• Описания объектов

• Правила медийного контента

• Использование MCD в качестве программы автоматического монтирования файловой системы

• Интерфейс менеджера ресурсов mcd

• Шаблоны вызова

• Уведомление о подключении и извлечении

• Определение медийного контента

• API-интерфейс клиента

• Дополнительная информация

[/dev/cd*]

Callout=CD_MEDIA_IOBLK

[/fs/usb*]

Callout=PATH_MEDIA_PROCMGR

[/directory/*]

Callout=PATH_MEDIA_SCAN

• контролирует заданный пользователем набор устройств и соответствующие носители медиаинформации;

• предпринимает попытки определения типа данных на носителях медиаинформации (например, звуковой компакт-диск или фильм на DVD-диске);

• уведомляет клиентов о наличии обнаруженной медиаинформации.

• носитель медиаинформации никогда не обозначает конкретный носитель медиаинформации; под ним всегда подразумевается любой носитель медиаинформации указанного типа: компакт-диск, но, например, не компакт-диск I'm Your Man Леонарда Коэна.

• неформатированный компакт-диск или USB-накопитель считается устройством, поскольку в исходном состоянии на нем отсутствует медийный контент;

• 
  USB-накопитель с двумя разделами – это одно устройство с двумя носителями медиаинформации.
  

1. Чтение конфигурационного файла;

2. Создание выделенного потока для доступа к интерфейсу менеджера ресурсов.

3. Для всех носителей медиаинформации, перечисленных в конфигурационном файле, выполняются следующие действия:

   1. Создание выделенного потока обнаружения устройства;

   2. Выполнение подпрограммы уведомления в отдельном потоке.

• создание нового потока обработки правил обнаружения контента для данного устройства, носителя медиаинформации или файла;

• завершение потока после завершения обработки правил.

• Описание объекта (устройства, носителя медиаинформации или файла) – имя раздела начинающееся с символа "/" (например, /dev/cd0). См. "Описания объектов" далее.

• Правило медийного контента – любое имя, не начинающееся с "/". См. "Правила медийного контента" далее.

[/dev/cd0]

Callout = CD_MEDIA_IOBLK

Argument = 1000,2000

Priority = 11,9

Start Rule = DVD_OR_CD

[DVD_AUDIO]

Callout = FNAME_MATCH

Argument = /AUDIO_TS/AUDIO_TS.IFO

Match Rule = DVD_VIDEO

Fail Rule = DVD_VIDEO

Callout=

Argument=

Priority=

• поток обнаружения контента;

• поток уведомления.

Start Rule=

Stop Rule=

Callout=

Argument=

Match Rule=

Fail Rule=

• Первый уровень записей в конфигурационном файле MCD охватывает не носители медиаинформации, а устройства, действия с которыми можно отслеживать с помощью доступных вызовов MCD.

• Параметр Start Rule= на первом уровне записей указывает на вызов MOUNT_FSYS, встроенной подпрограммы для монтирования файловых систем на основе простых критериев для носителей медиаинформации.

• При монтировании файловой системы на втором уровне записей (для носителей медиаинформации) используется уведомление о вставке с помощью встроенной подпрограммы PATH_MEDIA_PROCMGR.

• При инициировании, записи конфигурационного файла MCD второго уровня выполняют алгоритмы обнаружения контента на носителях медиаинформации в точке монтирования файловой системы.

• набор файлов S_IFNAM/name-special (.insert и .eject), используемых MCD для обеспечения API-интерфейса клиента с системой;

• каталог .devices, содержащий записи всех объектов, известных системе.

• st_mtime – время последнего изменения статуса объекта.

• st_ino – порядковый номер операции вставки. См. "Порядковый номер" далее.

$ ls -al /dev/mcd

dr-xr-xr-x 1 root root 11 Aug 02 19:46 .

n-w--w--w- 1 root root 0 Aug 02 19:46 .eject

n-w--w--w- 1 root root 0 Aug 02 19:46 .insert

nr--r--r-- 1 root root 0 Aug 02 19:46 CDDA_OR_DTS

nr--r--r-- 1 root root 0 Aug 02 19:46 CD_AUDIO

nr--r--r-- 1 root root 0 Aug 02 19:46 DVD_AUDIO

nr--r--r-- 1 root root 0 Aug 02 19:46 DVD_OR_CD

nr--r--r-- 1 root root 0 Aug 02 19:46 DVD_VIDEO

nr--r--r-- 1 root root 0 Aug 02 19:46 MIXED_AV

nr--r--r-- 1 root root 0 Aug 02 19:46 SVIDEO_CD

nr--r--r-- 1 root root 0 Aug 02 19:46 VIDEO_CD

• Если имя функции содержит символ "at" (@) (например, myfunc@mylib.so), то это внешняя функция в указанной DLL-библиотеке, которая преобразуется во время выполнения.

• Если имя функции не содержит символ @, выполняется вызов внутренней встроенной подпрограммы.

void mcd_notify( char *iomgr[2], char *device, void *arg );

• регистрация ошибки;

• остановка мониторинга объекта, в потоке мониторинга которого возникла ошибка;

• дальнейший мониторинг других потоков обнаружения объектов.

iomgr

device

arg

CD_MEDIA_IOBLK

USB_MEDIA_ENUM

PATH_MEDIA_PROCMGR

PATH_MEDIA_SCAN

• "/" присутствует – путевое имя существует как каталог (в т.ч. как корневой каталог смонтированной файловой системы), отправляется одно уведомление;

• "/" отсутствует – отправляется уведомление о каждом файле в указанном каталоге, соответствующем шаблону имени.

int mcd_content( char *device, void *arg );

device

arg

• MCD_RULE_MATCHED – соответствие для правила обнаружено.

• MCD_RULE_NO_MATCH – соответствие для правила не обнаружено.

• MCD_RULE_ABORT – возникла серьезная ошибка; устанавливается errno и процесс обнаружения для устройства завершается.

DVD_OR_CD

CD_AUDIO

BLANK_CD

FNAME_MATCH

• При выполнении цепочки правил вне устройства, представляющего собой файловую систему (например, [/fs/cd*]), эта файловая система является точкой монтирования, в которой правилом FNAME_MATCH осуществляется поиск имен файлов.

• В случае перехода к правилу FNAME_MATCH из устройства (например, [/dev/cd0]), это правило:

  1. определяет точку монтирования /dev/cd0 (вероятно, /fs/cd0);

  2. выполняет в файловой системе поиск совпадающих имен файлов.

FNAME_PATTERN

• basedir= – определить подкаталог, с которого начинается сканирование; по умолчанию используется корневой каталог текущего объекта;

• depth= – определить максимальное число уровней подкаталога для рекурсии (т.е. максимальная глубина от корневого каталога); значение по умолчанию – 0, т.е. предел глубины отсутствует.

MOUNT_FSYS

#Device_pattern Mount_point Fsys_type Mount_options

/dev/cd* /fs/cd%# udf normv

/dev/cd* /fs/cd%# cd normv,case=upper

/dev/umass*t1[124] /fs/usb%0 dos fsi=use

/dev/umass*t[146] /fs/usb%0 dos

/dev/hd*

• предпринимает попытку монтирования каждого компакт-диска как файловой системы UDF;

• в случае сбоя при монтировании компакт-диска в качестве файловой системы UDF – предпринимает попытку его монтирования как файловой системы ISO9660;

• игнорирует жесткие диски;

• монтирует /dev/cdn в качестве /fs/cd0n;

• монтирует разделы USB-устройства в качестве DOS в первую доступную точку монтирования файловой системы.

UNMOUNT_FSYS

• %# обеспечивает развертывание до номера основного устройства носителя медиаинформации. Например, если указано /fs/cd%#, то каталог /dev/cd0 монтируется в /fs/cd0, а каталог /dev/cd1 – в /fs/cd1. %# не допускает использование нескольких разделов; для этого доступна последовательность %0.

• %0 обеспечивает развертывание до следующего уникального номера. Преимущественно используется для применения правил нескольких разделов USB-устройства в mcd.mnt с именами точек монтирования /fs/usb%0. При наличии последовательности %0 в имени MCD выполняет попытку выделения каталогов /fs/usb0, /fs/usb1, /fs/usb2 и т.д. (начиная с 0) до обнаружения уникального имени точки монтирования. Например, если в /fs/usb0 и /fs/usb1 уже смонтированы файловые системы, MCD обеспечивает развертывание /fs/usb%0 до /fs/usb2.

Пример файла mcd.mnt, в котором используются специальные последовательности %# и %0:

#------------------------------------------------------

# Device Mountpt Type Options

#------------------------------------------------------

/dev/cd* /fs/cd%# cd normv

/dev/umass[0-9]* / enum

/dev/umass[0-9]*t1[1234] /fs/usb%0 dos

/dev/umass[0-9]*t1[1234].* /fs/usb%0 dos

/dev/umass[0-9]*t[146] /fs/usb%0 dos

/dev/umass[0-9]*t[146].* /fs/usb%0 dos

/dev/umass*t7[789] /fs/usb%0 qnx4

/dev/umass*t17[789] /fs/usb%0 qnx6 sync=optional

/dev/umass[0-9]* /fs/usb%0 dos

int fd, cd;

char device[_POSIX_PATH_MAX];

// Открыть правило CD_AUDIO и дождаться обнаружения соответствия.

fd = open("/dev/mcd/CD_AUDIO", O_RDONLY);

while (read(fd, device, sizeof(device)) != -1) {

// В этот момент в устройстве находится звуковой компакт-диск ...

cd = open(device, O_RDONLY);

// ... чтение содержимого, воспроизведение и т.д.

// Возможность отслеживания статуса воспроизведения с помощью

// DCMD_CAM_CDROMSUBCHNL.

// При извлечении диска будет завершено неуспешно.

// Возможность возврата и ожидания следующей вставки.

// Обновление правила для

// следующего совпадения.

close(cd);

}

close(fd);

fd = open(rulename, O_RDONLY | O_NONBLOCK);

SIGEV_UNBLOCK_INIT(&evt);

for (;;) {

while (ionotify(fd, _NOTIFY_ACTION_POLLARM, _NOTIFY_COND_INPUT,

&evt) != 0) {

while (read(fd, device, sizeof(device)) > 0) {

// значение "device" сопоставляется с "rulename".

}

}

pause();

}

// Получение уведомления о правилах с использованием чтения XTYPE

int fd;

uint32_t seq1;

char device[_POSIX_PATH_MAX];

fd = open("/dev/mcd/CD_AUDIO", O_RDONLY);

_readx(fd, device, sizeof(device), _IO_XFLAG_BLOCK | _IO_XTYPE_MQUEUE,

&seq1, sizeof(seq1));

// Открытие и проверка текущей версии вставленного устройства

int fd;

struct stat st;

uint32_t seq2;

char entry[_POSIX_PATH_MAX];

fd = open(device, O_RDONLY);

sprintf(device, "/dev/mcd/.devices/%s", device);

seq2 = (stat(device, &st) != -1) ? st.st_ino : 0;

// В случае совпадения правило CD_AUDIO не изменено и по-прежнему действительно,

// а каталог "fd" открыт в данной версии носителя

if (seq1 == seq2) ...

• Обнаружение других видов системных носителей

• Обнаружение устройств USB и iPod

• Сопоставление с шаблоном и учет регистра

• Сопоставление с единственным правилом

• Обнаружение компакт-дисков с данными, не являющимися медийным контентом

• Устройство смены компакт-дисков под управлением внешнего микропрограммного обеспечения

• Использование MCD в качестве перечислителя разделов

1. Определите отличие нового типа носителя от всех остальных типов. Во многих случаях разница может заключаться лишь в наличии на носителе медиаинформации определенных файлов или каталогов. Например, диск обновления для навигации можно распознать по наличию файла acios_db.ini или config.nfm. В этом случае для обнаружения используется встроенная подпрограмма, например FNAME_MATCH; также можно записать пользовательскую подпрограмму и передать ее в MCD во внешней DLL- библиотеке.
   
2. Определите приоритет проверки данного носителя по отношению к другим тестам (в первую или в последнюю очередь, после проверки звукового контента, но до проверки других правил данных и т.д.).
   
3. Создайте в конфигурационном файле новый раздел правила для данного теста с соответствующим правилом Callout= и соедините его с соответствующей точкой дерева решений путем изменения параметров Match Rule= или Fail Rule= как для предыдущего, так и для нового правила. При совпадении нового контента имя нового правила может использоваться для вызова любого клиентского приложения.
   

[/fs/usb*]

Callout = PATH_MEDIA_PROCMGR

Argument = /proc/mount

Priority = 11,10

Start Rule = ...

[/dev/umass/*]

Callout = USB_MEDIA_ENUM

Argument = /dev/umass-enum

Priority = 11,10

Start Rule = ...

[/fs/ipod*]

Callout = PATH_MEDIA_PROCMGR

Argument = /proc/mount

Priority = 11,10

Start Rule = ...

• используемой встроенной подпрограммы и

• базовой файловой системы.

• создать фиктивное правило без подпрограммы Callout=;

• создать ветвь Match Rule= (при этом при тестировании для правила всегда обнаруживается соответствие);

• определить это правило в качестве правила Start Rule= для устройства (для фиктивного правила создается ветвь к исходному начальному правилу).

[/dev/cd0]

Callout = CD_MEDIA_IOBLK

Argument = 1000,2000

Priority = 11,9

Start Rule = DISC_INSERTED

[DISC_INSERTED]

Match Rule = DVD_OR_CD

• В драйвере устройства ожидается загрузка устройства смены компакт-дисков и его доступность в системе.

• Если устройство смены компакт-дисков доступно, в контрольную точку MCD записывается его имя (в виде строки, например /dev/cd0). Запись имени устройства в контрольной точке инициирует последующие операции процесса обнаружения контента.

[/dev/cd0]

Priority = 11

Start Rule = ...

Код уведомления о вставке в драйвере:

int notify;

notify = open("/dev/mcd/.insert", O_WRONLY);

write(notify, "/dev/cd0", 8);

close(notify);

• Перечислитель USB-устройств должен быть настроен на запуск devb-umass с опцией blk auto=none; таким образом, автоматическое перечисление разделов не выполняется.

• Правило устройства MCD для USB-накопителя должно быть сконфигурировано следующим образом:

  • правило имеет формат [/dev/umass*], т.е. шаблон должен соответствовать как устройству без разделов, так и любым разделам;

  • в качестве опции Start Rule= определено правило, вызывающее MOUNT_FSYS.

• Для продолжения обработки после монтирования файловой системы из раздела или устройства следует создать набор правил точки монтирования второй фазы [/fs/usb*].

  Правило mcd.mnt, используемое MOUNT_FSYS, должно включать следующий код:

  /dev/umass[0-9]* / enum

  /dev/umass[0-9]* /fs/usb%# dos

  /dev/umass[0-9]*t1[124] /fs/usb%# dos fsi=use

  /dev/umass[0-9]*t[146] /fs/usb%# dos

1. USB-накопитель вставлен.

2. Перечислитель USB обнаруживает событие вставки и запускает devb-umass.

3. devb-umass создает путевое имя /dev/umassX и вызывает MCD.

4. MCD выполняет правило MOUNT_FSYS.

5. Если носитель не разбит на разделы:

   1. Выполняется правило enum, которое завершается неуспешно.

   2. После неуспешного выполнения кода предпринимается попытка монтирования fs-dos на устройстве без разделов, которая завершается успешно, и создается /fs/usb*.

6. Если носитель разбит на разделы:

   1. Правило enum перечисляет разделы и, таким образом, завершается успешно, вызов также завершается.

   2. В результате перечисления появляются имена /dev/umassXtN, повторно вводится правило устройства MCD с шаблоном, пропускающим правила enum, и вместо этого предпринимается попытка монтирования fs-dos в разделе, что приводит к созданию /fs/usb*.

7. После любого из последних действий (5 или 6) MOUNT_FSYS успешно выполняет монтирование, и MCD продолжает выполнение правил /fs/usb*, обычно для обнаружения контента или вызова фиктивного правила INSERT.

# Примеры правил идентификации CD/DVD-диска.

[/dev/cd0]

Callout = CD_MEDIA_IOBLK

Argument = 1000,2000

Priority = 11,9

Start Rule = DVD_OR_CD

[DVD_OR_CD]

Callout = DVD_OR_CD

Match Rule = DVD_AUDIO

Fail Rule = CD_AUDIO

[DVD_AUDIO]

Callout = FNAME_MATCH

Argument = /AUDIO_TS/AUDIO_TS.IFO

Match Rule = DVD_VIDEO

Fail Rule = DVD_VIDEO

[DVD_VIDEO]

Callout = FNAME_MATCH

Argument = /VIDEO_TS/VIDEO_TS.IFO

Fail Rule = VIDEO_CD

[CD_AUDIO]

Callout = CD_AUDIO

Match Rule = VIDEO_CD

Fail Rule = VIDEO_CD

[VIDEO_CD]

Callout = FNAME_MATCH

Argument = /VCD/INFO.VCD,/MPEGAV/AVSEQ01.DAT,/MPEGAV/MUSIC01.DAT

Fail Rule = SVIDEO_CD

[SVIDEO_CD]

Callout = FNAME_MATCH

Argument = /SVCD/INFO.SVD,/MPEGAV/AVSEQ01.MPG,/MPEG2/AVSEQ01.MPG

Fail Rule = MIXED_AV

[MIXED_AV]

Callout = FNAME_PATTERN

Argument = *.MP3,*.mp3,*.WMV,*.wmv,*.WMA,*.wma,*.AAC,*.aac,*.JPG,*.jpg,*.MPG,*.mpg

• При вставке носителя процесс обнаружения контента начинается с правила DVD_OR_CD.

• Если для правила обнаружено соответствие (носитель является DVD-диском), то процесс переходит к правилу DVD_AUDIO. Если соответствие правилу не обнаружено, то процесс переходит к правилу CD_AUDIO.

  Правило DVD_AUDIO предполагает (после выполнения встроенного теста FNAME_MATCH) существование на DVD-диске файла /AUDIO_TS/AUDIO_TS.IFO, что указывает на наличие звукового контента.

• Поскольку на DVD-диске может находиться как звуковой, так и видеоконтент, в любом случае выполняется переход к правилу DVD_VIDEO.

Это поведение аналогично поведению правила CD_AUDIO, поскольку компакт-диск может содержать как аудиофайлы, так и данные.

• Последнее правило MIXED_AV не имеет ветвей. Вне зависимости от результата, на этом правиле обработка завершается.

[/dev/umass*t*]

Callout = PATH_MEDIA_PROCMGR

Argument = /proc/mount

Priority = 11,10

Start Rule = MOUNT

[MOUNT]

Callout = MOUNT_FSYS

Argument = /dev/shmem/mcd.mnt

[/fs/usb*]

Callout = PATH_MEDIA_PROCMGR

Argument = /proc/mount

Priority = 11,10

Start Rule = MIXED_AV

[MIXED_AV]

Callout = FNAME_PATTERN

Argument = *.MP3,*.mp3,*.WMV,*.wmv,*.WMA,*.wma,*.AAC,*.aac,*.JPG,*.jpg,*.MPG,*.mpg

/dev/umass*t1[124] /fs/usb%# dos

/dev/umass*t[146] /fs/usb%# dos