IEC TR 62291:2002

TECHNICAL IEC
REPORT
TR 62291
First edition
2002-05
Multimedia data storage –
Application program interface
for UDF based file systems
Reference number
IEC/TR 62291:2002(E)
Publication numbering
As from 1 January 1997 all IEC publications are issued with a designation in the

60000 series. For example, IEC 34-1 is now referred to as IEC 60034-1.

Consolidated editions
The IEC is now publishing consolidated versions of its publications. For example,

edition numbers 1.0, 1.1 and 1.2 refer, respectively, to the base publication, the

base publication incorporating amendment 1 and the base publication incorporating

amendments 1 and 2.
Further information on IEC publications
The technical content of IEC publications is kept under constant review by the IEC,
thus ensuring that the content reflects current technology. Information relating to
this publication, including its validity, is available in the IEC Catalogue of
publications (see below) in addition to new editions, amendments and corrigenda.
Information on the subjects under consideration and work in progress undertaken
by the technical committee which has prepared this publication, as well as the list
of publications issued, is also available from the following:
• IEC Web Site (www.iec.ch)
• Catalogue of IEC publications
The on-line catalogue on the IEC web site (www.iec.ch/catlg-e.htm) enables
you to search by a variety of criteria including text searches, technical
committees and date of publication. On-line information is also available on
recently issued publications, withdrawn and replaced publications, as well as
corrigenda.
• IEC Just Published
This summary of recently issued publications (www.iec.ch/JP.htm) is also
available by email. Please contact the Customer Service Centre (see below) for
further information.
• Customer Service Centre
If you have any questions regarding this publication or need further assistance,
please contact the Customer Service Centre:
Email: custserv@iec.ch
Tel: +41 22 919 02 11
Fax: +41 22 919 03 00
TECHNICAL IEC
REPORT
TR 62291
First edition
2002-05
Multimedia data storage –
Application program interface
for UDF based file systems:
 IEC 2002  Copyright - all rights reserved
No part of this publication may be reproduced or utilized in any form or by any means, electronic or
mechanical, including photocopying and microfilm, without permission in writing from the publisher.
International Electrotechnical Commission, 3, rue de Varembé, PO Box 131, CH-1211 Geneva 20, Switzerland
Telephone: +41 22 919 02 11 Telefax: +41 22 919 03 00 E-mail: inmail@iec.ch  Web: www.iec.ch
PRICE CODE
Commission Electrotechnique Internationale
P
International Electrotechnical Commission
Международная Электротехническая Комиссия
For price, see current catalogue

– 2 – TR 62291 © IEC:2002(E)
CONTENTS
FOREWORD.3

INTRODUCTION.4

1 Scope.5

2 Reference documents .5

3 Definitions .5

4 Notation.6

5 File operations conforming to ISO/IEC 9945-1.6

6 UDF specific file operations .7
6.1 Header and data structure .7
6.2 Get UDF file attribute information.9
6.3 Set UDF file attribute information .10
7 Security extension .12
7.1 Header and data structure .12
7.2 Log operation .12
7.3 Licensing operation.13
Table 1 – File operations conforming to ISO/IEC 9945-1.6
Table 2 – udfent structure .7
Table 3 – udftag structure .7
Table 4 – timestamp structure .8
Table 5 – regid structure .8
Table 6 – udfxattr structure .8
Table 7 – udftime structure.8
Table 8 – aldesc structure .12
Table 9 – envspec structure .12

TR 62291 © IEC:2002(E) – 3 –
INTERNATIONAL ELECTROTECHNICAL COMMISSION

____________
MULTIMEDIA DATA STORAGE –
APPLICATION PROGRAM INTERFACE
FOR UDF BASED FILE SYSTEMS
FOREWORD
1) The IEC (International Electrotechnical Commission) is a worldwide organization for standardization comprising

all national electrotechnical committees (IEC National Committees). The object of the IEC is to promote
international co-operation on all questions concerning standardization in the electrical and electronic fields. To
this end and in addition to other activities, the IEC publishes International Standards. Their preparation is
entrusted to technical committees; any IEC National Committee interested in the subject dealt with may
participate in this preparatory work. International, governmental and non-governmental organizations liaising
with the IEC also participate in this preparation. The IEC collaborates closely with the International Organization
for Standardization (ISO) in accordance with conditions determined by agreement between the two
organizations.
2) The formal decisions or agreements of the IEC on technical matters express, as nearly as possible, an
international consensus of opinion on the relevant subjects since each technical committee has representation
from all interested National Committees.
3) The documents produced have the form of recommendations for international use and are published in the form
of standards, technical specifications, technical reports or guides and they are accepted by the National
Committees in that sense.
4) In order to promote international unification, IEC National Committees undertake to apply IEC International
Standards transparently to the maximum extent possible in their national and regional standards. Any
divergence between the IEC Standard and the corresponding national or regional standard shall be clearly
indicated in the latter.
5) The IEC provides no marking procedure to indicate its approval and cannot be rendered responsible for any
equipment declared to be in conformity with one of its standards.
6) Attention is drawn to the possibility that some of the elements of this technical report may be the subject of
patent rights. The IEC shall not be held responsible for identifying any or all such patent rights.
The main task of IEC technical committees is to prepare International Standards. However, a
technical committee may propose the publication of a technical report when it has collected
data of a different kind from that which is normally published as an International Standard, for
example “state of the art”.
Technical reports do not necessarily have to be reviewed until the data they provide are
considered to be no longer valid or useful by the maintenance team.
IEC 62291, which is a technical report has been prepared by IEC technical committee 100:
Audio, video and multimedia systems and equipment.

The text of this technical report is based on the following documents:
Enquiry draft Report on voting
100/399/CDV 100/455/RVC
Full information on the voting for the approval of this technical report can be found in the report
on voting indicated in the above table.
This publication has been drafted in accordance with the ISO/IEC Directives, Part 2.
This document, which is purely informative, is not to be regarded as an International Standard.

– 4 – TR 62291 © IEC:2002(E)
INTRODUCTION
Interchangeable storage media have been widely employed for information interchange; the

following extensions to their media format should therefore be standardized:

a) additional facilities including security (access control, originality management, etc.);

b) volume and file structure supporting the facilities;

c) API (Application Program Interfaces) to the volume and file structure.

For a number of disc media, ISO/IEC JTC1/SC15 developed a generic standard of volume and

file structure and it was actually used for rewritable, recordable and read-only DVD and

recordable CD file systems with some subsetting by OSTA (Optical Storage Technology
Association). The subsetting specification is called a UDF (Universal Disk Format).
Additional facilities and an API for the UDF have been discussed in OITDA (Optoelectronic
Industry and Technology Development Association). OITDA drafted their specifications and
submitted them to JISC (Japanese Industrial Standard Committee). METI (Ministry of
Economy, Trade and Industry, Japan) approved them and JSA (Japanese Standards
Association) published them in July 2001 as
a) JIS/TR X 0040:2001 Security Extension to Universal Disk Format (UDF);
b) JIS/TR X 0041:2001 Application Program Interface for UDF based File Systems.
IEC/TC100 National Committee of Japan then submitted the English version of JIS/TR X
0041:2001 to IEC/TC100.
TR 62291 © IEC:2002(E) – 5 –
MULTIMEDIA DATA STORAGE –
APPLICATION PROGRAM INTERFACE
FOR UDF BASED FILE SYSTEMS
1 Scope
This technical report (TR) specifies an application program interface (API) for reading and

writing the files which conform to the Universal Disk Format (UDF) specification revision 2.00
developed by the Optical Storage Technology Association (OSTA) and its security extension.
2 Reference documents
ISO/IEC 9945-1:1990, Information technology – Portable Operating System Interface (POSIX)
– Part 1: System Application Program Interface (API) (C Language)
Universal Disk Format (UDF) Specification Revision 2.00, OSTA, 1998
1)
Secure UDF, Revision 1.00, OSTA, 2002
JIS/TR X 0040:2001 Security Extension to Universal Disk Format (UDF)
3 Definitions
For the purposes of this technical report, the following definitions apply.
3.1
access logging
security feature to record and refer to operations for each file. An access logging contains
information on when the operation is applied, who applies the operation, and what type of
operation is applied
3.2
security function
function that an implementation shall apply to each file when the implementation accesses to
the files. A security function contains access logging, etc.
3.3
usage environment
environment in which use of contents is allowed
NOTE An example of the environment is a combination of specific storage medium, specific storage device and
specific decoder.
3.4
usage environment identifier
identifier for distinguishing a specific usage environment with other usage environments
NOTE A storage medium identifier can be used as a usage environment identifier.
3.5
license
encrypted decryption key for encrypted contents, i.e., a default stream and user streams
___________
1)
To be published.
– 6 – TR 62291 © IEC:2002(E)
3.6
secure UDF
Universal Disk Format (UDF) that contains the structures specified by JIS/TR X 0040 (or OSTA

Secure UDF, Revision 1.00)
4 Notation
The conventions for symbol constants that are returned by functions as error numbers shall

conform to the description on “error numbers” in 2.4 of ISO/IEC 9945-1:1990.

5 File operations conforming to ISO/IEC 9945-1
The file operations in Table 1 shall conform to the API (Application Program Interface)
specified by ISO/IEC 9945-1:1990.
Table 1 – File operations conforming to ISO/IEC 9945-1
Subclause
Function
of ISO/IEC Operation
name
9945-1
5.1.2 Directory Operations opendir()
readdir()
rewinddir()
closedir()
5.2.1 Change Current Working Directory chdir()
5.2.2 Working Directory Pathname getcwd()
5.3.1 Open a File open()
5.3.2 Create a New file or Rewrite an Existing One creat()
5.3.3 Set File Creation Mask umask()
5.3.4 Link to a File link()
5.4.1 Make a Directory mkdir()
5.4.2 Make a FIFO Special File mkfifo()
5.5.1 Remove Directory entries unlink()
5.5.2 Remove a Directory rmdir()
5.5.3 Rename a File rename()
5.6.2 Get File Status stat()
fstat()
5.6.3 File Accessibility access()
5.6.4 Change File Modes chmod()
5.6.5 Change Owner and Group of a File chown()
5.6.6 Sets File Access and Modification Times utime()
6.3.1 Close a File close()
6.4.1 Read from a File read()
6.4.2 Write to a File write()
6.5.2 File Control fcntl()
6.5.3 Reposition Read/Write File Offset lseek()

TR 62291 © IEC:2002(E) – 7 –
6 UDF specific file operations

This clause specifies UDF specific file operations.

6.1 Header and data structure
The udf.h header file includes the structure definitions that are dealt with in UDF file systems.

For information about each structure definition, see the UDF Specification revision 2.00.

6.1.1 File entry structures in udf.h

The udf.h header file defines the udfent UDF file entry structures th
...