xorriso  1.5.4.pl02
About: GNU xorriso creates, loads, manipulates and writes ISO 9660 filesystem images with Rock Ridge extensions. It is suitable for incremental data backup and for production of bootable ISO 9660 images. GNU xorriso is a statical compilation of the libraries libburn, libisofs, libisoburn, and libjte.
  Fossies Dox: xorriso-1.5.4.pl02.tar.gz  ("unofficial" and yet experimental doxygen-generated source code documentation)  

iso_read_opts Struct Reference

Data Fields

uint32_t block
 
unsigned int norock: 1
 
unsigned int nojoliet: 1
 
unsigned int noiso1999: 1
 
unsigned int noaaip: 1
 
unsigned int nomd5: 2
 
unsigned int make_new_ino: 1
 
unsigned int preferjoliet: 1
 
unsigned int ecma119_map: 2
 
unsigned int joliet_map: 1
 
uid_t uid
 
gid_t gid
 
mode_t dir_mode
 
mode_t file_mode
 
char * input_charset
 
int auto_input_charset
 
int load_system_area
 
int keep_import_src
 
int truncate_mode
 
int truncate_length
 

Detailed Description

Options for image reading. There are four kind of options:

  • Related to multisession support. In most cases, an image begins at LBA 0 of the data source. However, in multisession discs, the later image begins in the last session on disc. The block option can be used to specify the start of that last session.
  • Related to the tree that will be read. As default, when Rock Ridge extensions are present in the image, that will be used to get the tree. If RR extensions are not present, libisofs will use the Joliet extensions if available. Finally, the plain ISO-9660 tree is used if neither RR nor Joliet extensions are available. With norock, nojoliet, and preferjoliet options, you can change this default behavior.
  • Related to default POSIX attributes. When Rock Ridege extensions are not used, libisofs can't figure out what are the the permissions, uid or gid for the files. You should supply default values for that.

Definition at line 76 of file fs_image.c.

Field Documentation

◆ auto_input_charset

int iso_read_opts::auto_input_charset

Enable or disable methods to automatically choose an input charset. This eventually overrides input_charset.

bit0= allow to set the input character set automatically from attribute "isofs.cs" of root directory

Definition at line 139 of file fs_image.c.

Referenced by iso_image_filesystem_new(), and iso_read_opts_auto_input_charset().

◆ block

uint32_t iso_read_opts::block

Block where the image begins, usually 0, can be different on a multisession disc.

Definition at line 82 of file fs_image.c.

Referenced by iso_analyze_system_area(), iso_image_eval_boot_info_table(), iso_image_filesystem_new(), iso_image_import(), and iso_read_opts_set_start_block().

◆ dir_mode

mode_t iso_read_opts::dir_mode

Default mode when no RR (only permissions)

Definition at line 123 of file fs_image.c.

Referenced by iso_image_filesystem_new(), iso_read_opts_new(), and iso_read_opts_set_default_permissions().

◆ ecma119_map

unsigned int iso_read_opts::ecma119_map

If neither Rock Ridge nor Joliet is used, the ECMA-119 names are mapped according to one of these rules 0 = unmapped: show name as recorded in ECMA-119 directory record (not suitable for writing it to a new ISO filesystem) 1 = stripped: like unmapped, but strip off trailing ";1" or ".;1" 2 = uppercase: like stripped, but {a-z} mapped to {A-Z} 3 = lowercase: like stripped, but {A-Z} mapped to {a-z}

Definition at line 111 of file fs_image.c.

Referenced by iso_image_filesystem_new(), iso_read_opts_new(), and iso_read_opts_set_ecma119_map().

◆ file_mode

mode_t iso_read_opts::file_mode

◆ gid

gid_t iso_read_opts::gid

Default uid when no RR

Definition at line 122 of file fs_image.c.

Referenced by iso_image_filesystem_new(), and iso_read_opts_set_default_gid().

◆ input_charset

char* iso_read_opts::input_charset

Input charset for RR file names. NULL to use default locale charset.

Definition at line 130 of file fs_image.c.

Referenced by iso_image_filesystem_new(), iso_read_opts_free(), and iso_read_opts_set_input_charset().

◆ joliet_map

unsigned int iso_read_opts::joliet_map

If Joliet is used, apply one of these mapping rules: 0 = unmapped: show name as recorded in Joliet directory record (not suitable for writing it to a new ISO filesystem) 1 = stripped: strip off trailing ";1" or ".;1"

Definition at line 119 of file fs_image.c.

Referenced by iso_image_filesystem_new(), iso_read_opts_new(), and iso_read_opts_set_joliet_map().

◆ keep_import_src

int iso_read_opts::keep_import_src

Keep data source of imported ISO filesystem in IsoImage.import_src

Definition at line 151 of file fs_image.c.

Referenced by iso_image_import(), iso_read_opts_keep_import_src(), and iso_read_opts_new().

◆ load_system_area

int iso_read_opts::load_system_area

Enable or disable loading of the first 32768 bytes of the session and submission by iso_write_opts_set_system_area(data, 0).

Definition at line 146 of file fs_image.c.

Referenced by iso_image_import(), iso_read_opts_load_system_area(), and iso_read_opts_new().

◆ make_new_ino

unsigned int iso_read_opts::make_new_ino

Hand out new inode numbers and overwrite eventually read PX inode numbers. This will split apart any hardlinks.

Definition at line 94 of file fs_image.c.

Referenced by iso_image_filesystem_new(), iso_image_import(), and iso_read_opts_set_new_inos().

◆ noaaip

unsigned int iso_read_opts::noaaip

◆ noiso1999

unsigned int iso_read_opts::noiso1999

Definition at line 86 of file fs_image.c.

Referenced by iso_image_filesystem_new(), and iso_read_opts_set_no_iso1999().

◆ nojoliet

unsigned int iso_read_opts::nojoliet

Definition at line 85 of file fs_image.c.

Referenced by iso_image_filesystem_new(), and iso_read_opts_set_no_joliet().

◆ nomd5

unsigned int iso_read_opts::nomd5

◆ norock

unsigned int iso_read_opts::norock

Definition at line 84 of file fs_image.c.

Referenced by iso_image_filesystem_new(), and iso_read_opts_set_no_rockridge().

◆ preferjoliet

unsigned int iso_read_opts::preferjoliet

When both Joliet and RR extensions are present, the RR tree is used. If you prefer using Joliet, set this to 1.

Definition at line 100 of file fs_image.c.

Referenced by iso_image_filesystem_new(), and iso_read_opts_set_preferjoliet().

◆ truncate_length

int iso_read_opts::truncate_length

Definition at line 159 of file fs_image.c.

Referenced by iso_image_filesystem_new(), iso_image_import(), and iso_read_opts_new().

◆ truncate_mode

int iso_read_opts::truncate_mode

What to do in case of name longer than truncate_length: 0= throw FAILURE 1= truncate to truncate_length with MD5 of whole name at end

Definition at line 158 of file fs_image.c.

Referenced by iso_image_filesystem_new(), iso_image_import(), and iso_read_opts_new().

◆ uid

uid_t iso_read_opts::uid

Default uid when no RR

Definition at line 121 of file fs_image.c.

Referenced by iso_image_filesystem_new(), and iso_read_opts_set_default_uid().


The documentation for this struct was generated from the following file: