usr.sbin/makefs/cd9660.h

   1 /*      $NetBSD: cd9660.h,v 1.15 2010/10/27 18:51:34 christos Exp $     */
   2
   3 /*
   4  * Copyright (c) 2005 Daniel Watt, Walter Deignan, Ryan Gabrys, Alan
   5  * Perez-Rathke and Ram Vedam.  All rights reserved.
   6  *
   7  * This code was written by Daniel Watt, Walter Deignan, Ryan Gabrys,
   8  * Alan Perez-Rathke and Ram Vedam.
   9  *
  10  * Redistribution and use in source and binary forms, with or
  11  * without modification, are permitted provided that the following
  12  * conditions are met:
  13  * 1. Redistributions of source code must retain the above copyright
  14  *    notice, this list of conditions and the following disclaimer.
  15  * 2. Redistributions in binary form must reproduce the above
  16  *    copyright notice, this list of conditions and the following
  17  *    disclaimer in the documentation and/or other materials provided
  18  *    with the distribution.
  19  *
  20  * THIS SOFTWARE IS PROVIDED BY DANIEL WATT, WALTER DEIGNAN, RYAN
  21  * GABRYS, ALAN PEREZ-RATHKE AND RAM VEDAM ``AS IS'' AND ANY EXPRESS OR
  22  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  23  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  24  * DISCLAIMED.  IN NO EVENT SHALL DANIEL WATT, WALTER DEIGNAN, RYAN
  25  * GABRYS, ALAN PEREZ-RATHKE AND RAM VEDAM BE LIABLE FOR ANY DIRECT, INDIRECT,
  26  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  27  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  28  * USE,DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  29  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  30  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  31  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
  32  * OF SUCH DAMAGE.
  33  *
  34  * $FreeBSD$
  35  */
  36
  37 #ifndef _MAKEFS_CD9660_H
  38 #define _MAKEFS_CD9660_H
  39
  40 #include <inttypes.h>
  41 #include <assert.h>
  42 #include <errno.h>
  43 #include <fcntl.h>
  44 #include <stdarg.h>
  45 #include <stdio.h>
  46 #include <stdlib.h>
  47 #include <string.h>
  48 #include <unistd.h>
  49 #include <time.h>
  50 #include <limits.h>
  51 #include <sys/queue.h>
  52 #include <sys/param.h>
  53
  54 #include "makefs.h"
  55 #include "iso.h"
  56 #include "iso_rrip.h"
  57 #include "cd9660/cd9660_eltorito.h"
  58
  59 #ifdef DEBUG
  60 #define INODE_WARNX(__x)        warnx __x
  61 #else /* DEBUG */
  62 #define INODE_WARNX(__x)
  63 #endif /* DEBUG */
  64
  65 #define CD9660MAXPATH 4096
  66
  67 #define ISO_STRING_FILTER_NONE = 0x00
  68 #define ISO_STRING_FILTER_DCHARS = 0x01
  69 #define ISO_STRING_FILTER_ACHARS = 0x02
  70
  71 /*
  72 Extended preferences type, in the spirit of what makefs gives us (only ints)
  73 */
  74 typedef struct {
  75         const char  *shortName;         /* Short option */
  76         const char      *name;          /* option name */
  77         char            *value;         /* where to stuff the value */
  78         int             minLength;      /* minimum for value */
  79         int             maxLength;      /* maximum for value */
  80         const char      *desc;          /* option description */
  81         int             filterFlags;
  82 } string_option_t;
  83
  84 /******** STRUCTURES **********/
  85
  86 /*Defaults*/
  87 #define ISO_DEFAULT_VOLUMEID "MAKEFS_CD9660_IMAGE"
  88 #define ISO_DEFAULT_APPID "MAKEFS"
  89 #define ISO_DEFAULT_PUBLISHER "MAKEFS"
  90 #define ISO_DEFAULT_PREPARER "MAKEFS"
  91
  92 #define ISO_VOLUME_DESCRIPTOR_STANDARD_ID "CD001"
  93 #define ISO_VOLUME_DESCRIPTOR_BOOT 0
  94 #define ISO_VOLUME_DESCRIPTOR_PVD 1
  95 #define ISO_VOLUME_DESCRIPTOR_TERMINATOR 255
  96
  97 /*30 for name and extension, as well as version number and padding bit*/
  98 #define ISO_FILENAME_MAXLENGTH_BEFORE_VERSION 30
  99 #define ISO_FILENAME_MAXLENGTH  36
 100 #define ISO_FILENAME_MAXLENGTH_WITH_PADDING 37
 101
 102 #define ISO_FLAG_CLEAR 0x00
 103 #define ISO_FLAG_HIDDEN 0x01
 104 #define ISO_FLAG_DIRECTORY 0x02
 105 #define ISO_FLAG_ASSOCIATED 0x04
 106 #define ISO_FLAG_PERMISSIONS 0x08
 107 #define ISO_FLAG_RESERVED5 0x10
 108 #define ISO_FLAG_RESERVED6 0x20
 109 #define ISO_FLAG_FINAL_RECORD 0x40
 110
 111 #define ISO_PATHTABLE_ENTRY_BASESIZE 8
 112
 113 #define ISO_RRIP_DEFAULT_MOVE_DIR_NAME "RR_MOVED"
 114 #define RRIP_DEFAULT_MOVE_DIR_NAME ".rr_moved"
 115
 116 #define CD9660_BLOCKS(__sector_size, __bytes)   \
 117         howmany((__bytes), (__sector_size))
 118
 119 #define CD9660_MEM_ALLOC_ERROR(_F)      \
 120     err(EXIT_FAILURE, "%s, %s l. %d", _F, __FILE__, __LINE__)
 121
 122 #define CD9660_IS_COMMAND_ARG_DUAL(var,short,long)\
 123                 (strcmp((var),(short)) == 0) || (strcmp((var),(long))==0)
 124
 125 #define CD9660_IS_COMMAND_ARG(var,arg)\
 126                 (strcmp((var),(arg)) == 0)
 127
 128 #define CD9660_TYPE_FILE        0x01
 129 #define CD9660_TYPE_DIR         0x02
 130 #define CD9660_TYPE_DOT         0x04
 131 #define CD9660_TYPE_DOTDOT      0x08
 132 #define CD9660_TYPE_VIRTUAL     0x80
 133
 134 #define CD9660_INODE_HASH_SIZE  1024
 135 #define CD9660_SECTOR_SIZE      2048
 136
 137 #define CD9660_END_PADDING      150
 138
 139 /* Slight modification of the ISO structure in iso.h */
 140 typedef struct _iso_directory_record_cd9660 {
 141         u_char length                   [ISODCL (1, 1)];        /* 711 */
 142         u_char ext_attr_length          [ISODCL (2, 2)];        /* 711 */
 143         u_char extent                   [ISODCL (3, 10)];       /* 733 */
 144         u_char size                     [ISODCL (11, 18)];      /* 733 */
 145         u_char date                     [ISODCL (19, 25)];      /* 7 by 711 */
 146         u_char flags                    [ISODCL (26, 26)];
 147         u_char file_unit_size           [ISODCL (27, 27)];      /* 711 */
 148         u_char interleave               [ISODCL (28, 28)];      /* 711 */
 149         u_char volume_sequence_number   [ISODCL (29, 32)];      /* 723 */
 150         u_char name_len                 [ISODCL (33, 33)];      /* 711 */
 151         char name                       [ISO_FILENAME_MAXLENGTH_WITH_PADDING];
 152 } iso_directory_record_cd9660;
 153
 154 /* TODO: Lots of optimization of this structure */
 155 typedef struct _cd9660node {
 156         u_char  type;/* Used internally */
 157         /* Tree structure */
 158         struct _cd9660node      *parent;        /* parent (NULL if root) */
 159         TAILQ_HEAD(cd9660_children_head, _cd9660node)   cn_children;
 160         TAILQ_ENTRY(_cd9660node)                cn_next_child;
 161
 162         struct _cd9660node *dot_record; /* For directories, used mainly in RRIP */
 163         struct _cd9660node *dot_dot_record;
 164
 165         fsnode          *node;          /* pointer to fsnode */
 166         struct _iso_directory_record_cd9660     *isoDirRecord;
 167         struct iso_extended_attributes  *isoExtAttributes;
 168
 169         /***** SIZE CALCULATION *****/
 170         /*already stored in isoDirRecord, but this is an int version, and will be
 171                 copied to isoDirRecord on writing*/
 172         uint32_t fileDataSector;
 173
 174         /*
 175          * same thing, though some notes:
 176          * If a file, this is the file size
 177          * If a directory, this is the size of all its children's
 178          *      directory records
 179          * plus necessary padding
 180          */
 181         int64_t fileDataLength;
 182
 183         int64_t fileSectorsUsed;
 184         int fileRecordSize;/*copy of a variable, int for quicker calculations*/
 185
 186         /* Old name, used for renaming - needs to be optimized but low priority */
 187         char o_name [ISO_FILENAME_MAXLENGTH_WITH_PADDING];
 188
 189         /***** SPACE RESERVED FOR EXTENSIONS *****/
 190         /* For memory efficiency's sake - we should move this to a separate struct
 191                 and point to null if not needed */
 192         /* For Rock Ridge */
 193         struct _cd9660node *rr_real_parent, *rr_relocated;
 194
 195         int64_t susp_entry_size;
 196         int64_t susp_dot_entry_size;
 197         int64_t susp_dot_dot_entry_size;
 198
 199         /* Continuation area stuff */
 200         int64_t susp_entry_ce_start;
 201         int64_t susp_dot_ce_start;
 202         int64_t susp_dot_dot_ce_start;
 203
 204         int64_t susp_entry_ce_length;
 205         int64_t susp_dot_ce_length;
 206         int64_t susp_dot_dot_ce_length;
 207
 208         /* Data to put at the end of the System Use field */
 209         int64_t su_tail_size;
 210         char *su_tail_data;
 211
 212         /*** PATH TABLE STUFF ***/
 213         int level;                      /*depth*/
 214         int ptnumber;
 215         struct _cd9660node *ptnext, *ptprev, *ptlast;
 216
 217         /* SUSP entries */
 218         TAILQ_HEAD(susp_linked_list, ISO_SUSP_ATTRIBUTES) head;
 219 } cd9660node;
 220
 221 typedef struct _path_table_entry
 222 {
 223         u_char length[ISODCL (1, 1)];
 224         u_char extended_attribute_length[ISODCL (2, 2)];
 225         u_char first_sector[ISODCL (3, 6)];
 226         u_char parent_number[ISODCL (7, 8)];
 227         u_char name[ISO_FILENAME_MAXLENGTH_WITH_PADDING];
 228 } path_table_entry;
 229
 230 typedef struct _volume_descriptor
 231 {
 232         u_char *volumeDescriptorData; /*ALWAYS 2048 bytes long*/
 233         int64_t sector;
 234         struct _volume_descriptor *next;
 235 } volume_descriptor;
 236
 237 typedef struct _iso9660_disk {
 238         int sectorSize;
 239         struct iso_primary_descriptor           primaryDescriptor;
 240         struct iso_supplementary_descriptor     supplementaryDescriptor;
 241
 242         volume_descriptor *firstVolumeDescriptor;
 243
 244         cd9660node *rootNode;
 245
 246         const char *rootFilesystemPath;
 247
 248         /* Important sector numbers here */
 249         /* primaryDescriptor.type_l_path_table*/
 250         int64_t primaryBigEndianTableSector;
 251
 252         /* primaryDescriptor.type_m_path_table*/
 253         int64_t primaryLittleEndianTableSector;
 254
 255         /* primaryDescriptor.opt_type_l_path_table*/
 256         int64_t secondaryBigEndianTableSector;
 257
 258         /* primaryDescriptor.opt_type_m_path_table*/
 259         int64_t secondaryLittleEndianTableSector;
 260
 261         /* primaryDescriptor.path_table_size*/
 262         int pathTableLength;
 263         int64_t dataFirstSector;
 264
 265         int64_t totalSectors;
 266         /* OPTIONS GO HERE */
 267         int     isoLevel;
 268
 269         int include_padding_areas;
 270
 271         int follow_sym_links;
 272         int verbose_level;
 273         int displayHelp;
 274         int keep_bad_images;
 275
 276         /* SUSP options and variables */
 277         int64_t susp_continuation_area_start_sector;
 278         int64_t susp_continuation_area_size;
 279         int64_t susp_continuation_area_current_free;
 280
 281         int rock_ridge_enabled;
 282         /* Other Rock Ridge Variables */
 283         char *rock_ridge_renamed_dir_name;
 284         int rock_ridge_move_count;
 285         cd9660node *rr_moved_dir;
 286
 287         int archimedes_enabled;
 288         int chrp_boot;
 289
 290         /* Spec breaking options */
 291         u_char allow_deep_trees;
 292         u_char allow_start_dot;
 293         u_char allow_max_name; /* Allow 37 char filenames*/
 294         u_char allow_illegal_chars; /* ~, !, # */
 295         u_char allow_lowercase;
 296         u_char allow_multidot;
 297         u_char omit_trailing_period;
 298
 299         /* BOOT INFORMATION HERE */
 300         int has_generic_bootimage; /* Default to 0 */
 301         char *generic_bootimage;
 302
 303         int is_bootable;/* Default to 0 */
 304         int64_t boot_catalog_sector;
 305         boot_volume_descriptor *boot_descriptor;
 306         char * boot_image_directory;
 307
 308         TAILQ_HEAD(boot_image_list,cd9660_boot_image) boot_images;
 309         int image_serialno;
 310         LIST_HEAD(boot_catalog_entries,boot_catalog_entry) boot_entries;
 311
 312 } iso9660_disk;
 313
 314 /******** GLOBAL VARIABLES ***********/
 315 extern iso9660_disk diskStructure;
 316
 317 /************ FUNCTIONS **************/
 318 int                     cd9660_valid_a_chars(const char *);
 319 int                     cd9660_valid_d_chars(const char *);
 320 void                    cd9660_uppercase_characters(char *, int);
 321
 322 /* ISO Data Types */
 323 void                    cd9660_721(uint16_t, unsigned char *);
 324 void                    cd9660_731(uint32_t, unsigned char *);
 325 void                    cd9660_722(uint16_t, unsigned char *);
 326 void                    cd9660_732(uint32_t, unsigned char *);
 327 void                    cd9660_bothendian_dword(uint32_t dw, unsigned char *);
 328 void                    cd9660_bothendian_word(uint16_t dw, unsigned char *);
 329 void                    cd9660_set_date(char *, time_t);
 330 void                    cd9660_time_8426(unsigned char *, time_t);
 331 void                    cd9660_time_915(unsigned char *, time_t);
 332
 333 /*** Boot Functions ***/
 334 int     cd9660_write_generic_bootimage(FILE *);
 335 int     cd9660_add_generic_bootimage(const char *);
 336 int     cd9660_write_boot(FILE *);
 337 int     cd9660_add_boot_disk(const char *);
 338 int     cd9660_eltorito_add_boot_option(const char *, const char *);
 339 int     cd9660_setup_boot(int);
 340 int     cd9660_setup_boot_volume_descriptor(volume_descriptor *);
 341
 342
 343 /*** Write Functions ***/
 344 int     cd9660_write_image(const char *image);
 345 int     cd9660_copy_file(FILE *, off_t, const char *);
 346
 347 void    cd9660_compute_full_filename(cd9660node *, char *, int);
 348 int     cd9660_compute_record_size(cd9660node *);
 349
 350 /* Debugging functions */
 351 void    debug_print_tree(cd9660node *,int);
 352 void    debug_print_path_tree(cd9660node *);
 353 void    debug_print_volume_descriptor_information(void);
 354 void    debug_dump_to_xml_ptentry(path_table_entry *,int, int);
 355 void    debug_dump_to_xml_path_table(FILE *, off_t, int, int);
 356 void    debug_dump_to_xml(FILE *);
 357 int     debug_get_encoded_number(unsigned char *, int);
 358 void    debug_dump_integer(const char *, char *,int);
 359 void    debug_dump_string(const char *,unsigned char *,int);
 360 void    debug_dump_directory_record_9_1(unsigned char *);
 361 void    debug_dump_to_xml_volume_descriptor(unsigned char *,int);
 362
 363 void    cd9660_pad_string_spaces(char *, int);
 364
 365 #endif