IEC TR 62291-2009 Multimedia data storage - Application program interface for UDF based file systems《多媒体数据存储.UDF基文件体系的应用程序接口》.pdf

1、 IEC/TR 62291 Edition 2.0 2009-02 TECHNICAL REPORT Multimedia data storage Application program interface for UDF based file systems IEC/TR 62291:2009(E) THIS PUBLICATION IS COPYRIGHT PROTECTED Copyright 2009 IEC, Geneva, Switzerland All rights reserved. Unless otherwise specified, no part of this pu

2、blication may be reproduced or utilized in any form or by any means, electronic or mechanical, including photocopying and microfilm, without permission in writing from either IEC or IECs member National Committee in the country of the requester. If you have any questions about IEC copyright or have

3、an enquiry about obtaining additional rights to this publication, please contact the address below or your local IEC member National Committee for further information. Droits de reproduction rservs. Sauf indication contraire, aucune partie de cette publication ne peut tre reproduite ni utilise sous

4、quelque forme que ce soit et par aucun procd, lectronique ou mcanique, y compris la photocopie et les microfilms, sans laccord crit de la CEI ou du Comit national de la CEI du pays du demandeur. Si vous avez des questions sur le copyright de la CEI ou si vous dsirez obtenir des droits supplmentaires

5、 sur cette publication, utilisez les coordonnes ci-aprs ou contactez le Comit national de la CEI de votre pays de rsidence. IEC Central Office 3, rue de Varemb CH-1211 Geneva 20 Switzerland Email: inmailiec.ch Web: www.iec.ch About IEC publications The technical content of IEC publications is kept u

6、nder constant review by the IEC. Please make sure that you have the latest edition, a corrigenda or an amendment might have been published. Catalogue of IEC publications: www.iec.ch/searchpub The IEC on-line Catalogue enables you to search by a variety of criteria (reference number, text, technical

7、committee,). It also gives information on projects, withdrawn and replaced publications. IEC Just Published: www.iec.ch/online_news/justpub Stay up to date on all new IEC publications. Just Published details twice a month all new publications released. Available on-line and also by email. Electroped

8、ia: www.electropedia.org The worlds leading online dictionary of electronic and electrical terms containing more than 20 000 terms and definitions in English and French, with equivalent terms in additional languages. Also known as the International Electrotechnical Vocabulary online. Customer Servic

9、e Centre: www.iec.ch/webstore/custserv If you wish to give us your feedback on this publication or need further assistance, please visit the Customer Service Centre FAQ or contact us: Email: csciec.ch Tel.: +41 22 919 02 11 Fax: +41 22 919 03 00 IEC/TR 62291 Edition 2.0 2009-02 TECHNICAL REPORT Mult

10、imedia data storage Application program interface for UDF based file systems INTERNATIONAL ELECTROTECHNICAL COMMISSION Q ICS 33.160.40; 35.220 PRICE CODE ISBN 2-8318-1031-0 Registered trademark of the International Electrotechnical Commission 2 TR 62291 IEC:2009(E) CONTENTS FOREWORD.3 INTRODUCTION.5

11、 1 Scope.6 2 Normative references .6 3 Terms and definitions .6 4 Notation .7 5 File operations conforming to ISO/IEC 9945-27 6 UDF specific file operations8 6.1 Header and data structure.8 6.1.1 General .8 6.1.2 File entry structures in udf.h 8 6.1.3 Extended attribute structure in udf.h10 6.1.4 Da

12、te and time structure in udf.h.10 6.1.5 Permission structure in udf.h .11 6.2 Get UDF file attribute information 11 6.2.1 Get a UDF file entry.11 6.2.2 Get UDF extended attribute.12 6.3 Set UDF file attribute information 12 6.3.1 Set a access permission12 6.3.2 Set a date and time .13 7 Security ext

13、ension14 7.1 General .14 7.2 Header and data structure.14 7.2.1 Header file.14 7.2.2 Access log descriptor structure in the udfse.h header file 14 7.3 Log operation 14 7.3.1 General .14 7.3.2 Get a log .14 7.4 Licensing operation .15 7.4.1 Get a license list15 7.4.2 Add a license.15 7.4.3 Delete a l

14、icense.16 7.4.4 Set a license16 Table 1 File operations conforming to ISO/IEC 9945-2.8 Table 2 udfent structure.9 Table 3 udftag structure.9 Table 4 timestamp structure.10 Table 5 regid structure.10 Table 6 udfxattr structure.10 Table 7 udftime structure .10 Table 8 aldesc structure.14 Table 9 envsp

15、ec structure14 TR 62291 IEC:2009(E) 3 INTERNATIONAL ELECTROTECHNICAL COMMISSION _ MULTIMEDIA DATA STORAGE APPLICATION PROGRAM INTERFACE FOR UDF BASED FILE SYSTEMS FOREWORD 1) The International Electrotechnical Commission (IEC) is a worldwide organization for standardization comprising all national e

16、lectrotechnical committees (IEC National Committees). The object of 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, IEC publishes International Standards, Technical Spec

17、ifications, Technical Reports, Publicly Available Specifications (PAS) and Guides (hereafter referred to as “IEC Publication(s)”). Their preparation is entrusted to technical committees; any IEC National Committee interested in the subject dealt with may participate in this preparatory work. Interna

18、tional, governmental and non- governmental organizations liaising with the IEC also participate in this preparation. IEC collaborates closely with the International Organization for Standardization (ISO) in accordance with conditions determined by agreement between the two organizations. 2) The form

19、al decisions or agreements of 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 IEC National Committees. 3) IEC Publications have the form of recommendations fo

20、r international use and are accepted by IEC National Committees in that sense. While all reasonable efforts are made to ensure that the technical content of IEC Publications is accurate, IEC cannot be held responsible for the way in which they are used or for any misinterpretation by any end user. 4

21、) In order to promote international uniformity, IEC National Committees undertake to apply IEC Publications transparently to the maximum extent possible in their national and regional publications. Any divergence between any IEC Publication and the corresponding national or regional publication shal

22、l be clearly indicated in the latter. 5) IEC provides no marking procedure to indicate its approval and cannot be rendered responsible for any equipment declared to be in conformity with an IEC Publication. 6) All users should ensure that they have the latest edition of this publication. 7) No liabi

23、lity shall attach to IEC or its directors, employees, servants or agents including individual experts and members of its technical committees and IEC National Committees for any personal injury, property damage or other damage of any nature whatsoever, whether direct or indirect, or for costs (inclu

24、ding legal fees) and expenses arising out of the publication, use of, or reliance upon, this IEC Publication or any other IEC Publications. 8) Attention is drawn to the Normative references cited in this publication. Use of the referenced publications is indispensable for the correct application of

25、this publication. 9) Attention is drawn to the possibility that some of the elements of this IEC Publication may be the subject of patent rights. 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 Sta

26、ndards. 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”. IEC 62291, which is a technical report has been prepared by IEC

27、technical committee 100: Audio, video and multimedia systems and equipment. This second edition cancels and replaces the first edition, published in 2002, and constitutes a technical revision. The significant changes with respect to the first edition are the following: reference document ISO/IEC 994

28、5-1:1990 is replaced with ISO/IEC 9945-2:2003. reference document UDF 2.00 is replaced with UDF 2.01. 4 TR 62291 IEC:2009(E) The text of this technical report is based on the following documents: Enquiry draft Report on voting 100/1452/CDV 100/1499/RVC Full information on the voting for the approval

29、 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. The committee has decided that the contents of this publication will remain unchanged until the maintenance result dateind

30、icated on the IEC web site under “http:/webstore.iec.ch“ in the data related to the specific publication. At this date, the publication will be reconfirmed, withdrawn, replaced by a revised edition, or amended. A bilingual version of this publication may be issued at a later date. TR 62291 IEC:2009(

31、E) 5 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 struc

32、ture 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 fi

33、le 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 dr

34、afted 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 Forma

35、t (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. 6 TR 62291 IEC:2009(E) MULTIMEDIA DATA STORAGE APPLICATION PROGRAM INTERFACE FOR UDF BASED FILE SYSTEM

36、S 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) 1specification revision 2.00 developed by the Optical Storage Technology Association (OSTA) and its security extension. 2 Normative

37、 references The following referenced documents are indispensable for the application of this document. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments) applies. ISO/IEC 9945-2:2003, Information tech

38、nology Portable Operating System Interface (POSIX) Part 2: System Interfaces Universal Disk Format (UDF) Specification Revision 2.01, Optical Storage Technology Association (OSTA), 2000 Secure UDF, Revision 1.00, OSTA, 2002 JIS/TR X 0040:2001, Security Extension to Universal Disk Format (UDF) NOTE J

39、IS/TR X 0040 was translated into English under the title Secure UDF Specification (2002), see reference above. 3 Terms and 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 a

40、ccess 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 ensures that an implementation applies to each file when the implementation accesses to the files NOTE A security function contain

41、s access logging, etc. 1Universal Disk Format (UDF) is a registered trademark developed by the Optical Storage Technology Association. This information is given for the convenience of users of this document and does not constitute an endorsement by IEC of the product named. Equivalent products may b

42、e used if they can be shown to lead to the same results. TR 62291 IEC:2009(E) 7 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 id

43、entifier 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 3.6 secure UDF Univer

44、sal 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 conform to the description on “error numbers” in 2.3 of ISO/IEC 9945-2:2003. 5 File operat

45、ions conforming to ISO/IEC 9945-2 The file operations in Table 1 conform to the system interfaces specified by ISO/IEC 9945-2:2003. 8 TR 62291 IEC:2009(E) Table 1 File operations conforming to ISO/IEC 9945-2 ISO/IEC 9945-2 Clause Operation Function name 3 Directory Operations opendir() readdir() rew

46、inddir() closedir() 3 Change Current Working Directory chdir() 3 Working Directory Pathname getcwd() 3 Open a File open() 3 Create a New file or Rewrite an Existing One creat() 3 Set File Creation Mask umask() 3 Link to a File link() 3 Make a Directory mkdir() 3 Make a FIFO Special File mkfifo() 3 R

47、emove Directory entries unlink() 3 Remove a Directory rmdir() 3 Rename a File rename() 3 Get File Status stat() fstat() 3 File Accessibility access() 3 Change File Modes chmod() 3 Change Owner and Group of a File chown() 3 Sets File Access and Modification Times utime() 3 Close a File close() 3 Read

48、 from a File read() 3 Write to a File write() 3 File Control fcntl() 3 Reposition Read/Write File Offset lseek() 6 UDF specific file operations This clause specifies UDF specific file operations. 6.1 Header and data structure 6.1.1 General The udf.h header file includes the structure definitions tha

49、t are dealt with in UDF file systems. For information about each structure definition, see the UDF Specification revision 2.01. 6.1.2 File entry structures in udf.h The udf.h header file defines the udfent UDF file entry structures that are returned by the udfgetent() function. Tables 2 to 5 list the definitions of related structures. TR 62291 IEC:2009(E) 9 Table 2 udfent structure Member type Member name Description Udftag desc_tag