This file is indexed.

/usr/include/hfsplus/hfsp.h is in libhfsp-dev 1.0.4-15.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
/*
 * libhfsp - library for reading and writing Macintosh HFS+ volumes
 * 
 * This file includes definitions for the structures found on
 * HFS+ Volumes. The structures are further wrapped by struct
 * found in libhfsp.h. fucntions on those enhanced structures
 * are found in files mentioned in comments below.
 *
 * Copyright (C) 2000 Klaus Halfmann <klaus.halfmann@feri.de>
 * Original code 1996-1998 by Robert Leslie <rob@mars.rog>
 * other work 2000 from Brad Boyer (flar@pants.nu) 
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 *
 * $Id: hfsp.h,v 1.1.1.1 2002/03/05 19:50:28 klaus Exp $
 */

/* # include <time.h> */

#define HFSP_BLOCKSZ            512	/* A sector for Apple is always 512 bytes */
#define HFSP_BLOCKSZ_BITS       9	/* 1<<9 == 512  */
#define	HFSP_VOLHEAD_SIG	0x482B	/* 'H+'	*/

// Minimum Key size for all btrees
#define HFSP_CAT_KEY_MIN_LEN	6

// Maximum Key size for all btrees
#define HFSP_CAT_KEY_MAX_LEN	516

/* HFS+ includes POSIX permissions , although marked as reserved they will be
 * used as such. Is ignored by MacOS 8-9 but probably not by MacOS X.
 */
typedef struct {
        UInt32         owner;
        UInt32         group;
        UInt32         mode;
        UInt32         dev;
} hfsp_perm;

/* A single contiguous area (fragment) of a file */
typedef struct {
        UInt32         start_block;
        UInt32         block_count;
} hfsp_extent;

/* A file may contain up to 8 normale extents, all other
   are found in some extra extent area */
typedef hfsp_extent hfsp_extent_rec[8];

/* Information for a "Fork" in a file
 * Forks are the "usual" DATA and RSRC forks or special files
 * (e.g. the Volume Bitmap)
 */
typedef struct {
        UInt64		total_size;  // logical size
        UInt32		clump_size;  // number of bytes to preallocate
        UInt32		total_blocks;
        hfsp_extent_rec extents;     // initial (8) extents
} hfsp_fork_raw;

/* HFS+ Volume Header
 * Always found at block 2 of the disk, a copy is stored
 * at the second to last block of the disk.
 */
typedef struct hfsp_vh {
        UInt16         signature;   // must be HFSPLUS_VOLHEAD_SIG 'H+'
        UInt16         version;     // currently 4, ignored 
        UInt32         attributes;  // See bit constants below
        UInt32         last_mount_vers;
                // Use a registered creator code here (See libhfsp.h)
		// Mac OS uses '8.10' well
        UInt32         reserved;
 
        UInt32         create_date; // local time !
        UInt32         modify_date; // GMT (?)
        UInt32         backup_date; // GMT (?)
        UInt32         checked_date; // GMT (?) fsck ?
 
        UInt32         file_count;
         // not including special files but including DATA and RSRC forks
        UInt32         folder_count; // excluding the root folder
 
        UInt32         blocksize;
         // must be multiple of HFSPLUS_SECTOR_SIZE,
         // should be a multiple of 4k for harddisk
        UInt32         total_blocks;
        UInt32         free_blocks;
         // The total number of unused allocation blocks on the disk.
 
        UInt32         next_alloc;
         // hint where to search for next allocation blocks
        UInt32         rsrc_clump_sz;
         // default clump size for rsrc forks
        UInt32         data_clump_sz;
         // default clump size for data forks
        UInt32	       next_cnid;
         // next unused catalog id
        UInt32         write_count;
         // increment on every mount (and write ?)
        UInt64        encodings_bmp;
                // for every encoding used on the disk a bit is set
                // ignored but eventually must be cared for
        Char          finder_info[32];                                      
	hfsp_fork_raw   alloc_file;
         // stores bitmap of use/free blocks
        hfsp_fork_raw   ext_file;
         // stores oferflow extents
        hfsp_fork_raw   cat_file;
	 // This contains the root directory
        hfsp_fork_raw   attr_file;
        hfsp_fork_raw   start_file;
         // a special startup file may be described here (used by ?)
} hfsp_vh;

/* HFS+ volume attributes */
/* 0-6 reserved, may be used in memory only */
#define HFSPLUS_VOL_RESERVED1 0x000000FF
#define HFSPLUS_VOL_HARDLOCK  0x00000080 // Used in Memory by finder only
#define HFSPLUS_VOL_UNMNT     0x00000100
        // clear this bit when mounting, set as last step of unmounting
        // This is checked by (slower) ROM code
#define HFSPLUS_VOL_SPARE_BLK 0x00000200
#define HFSPLUS_VOL_NOCACHE   0x00000400
        // in case of RAM or ROM disk (try a HFS+ Ramdisk :)
#define HFSPLUS_VOL_INCNSTNT  0x00000800
        // Reverse meaning as of HFSPLUS_VOL_UNMNT
        // This is checked by (faster) Mac OS code
/* 12-14 reserved */
#define HFSPLUS_VOL_RESERVED2 0x00007000
#define HFSPLUS_VOL_SOFTLOCK  0x00008000
#define HFSPLUS_VOL_RESERVED3 0xFFFF0000

/* HFS+ Btree node descriptor */
typedef struct {
	UInt32	    next;   /* pointer to next node of this kind, or 0 */
			    /* Header Node points to first MAP node */
	UInt32	    prev;   /* pointer to previous node of this kind, or 0 */
	UInt8	    kind;   /* see below */
	UInt8	    height; /* root node starts with 0 */
	UInt16	    num_rec;	/* number of records in this node */
	UInt16	    reserved;	/* fill up to 4 byte alignment */
} btree_node_desc;

/* HFS+ Btree Node types */
#define HFSP_NODE_NDX	0x00
#define HFSP_NODE_HEAD	0x01
#define HFSP_NODE_MAP	0x02
#define HFSP_NODE_LEAF	0xFF

#define HFSP_CATALOG_MIN_NODE_SIZE  0x1000
#define HFSP_ATTRMIN_DOE_SIZE	    0x1000

/* The record offsets are found at the end of the fork
 * containing the Btree */

typedef UInt16	btree_record_offset;

typedef struct {
        UInt16         depth;
	    // equal to height of btree_node_desc
        UInt32         root;
	    // root node of the hierarchy 
        UInt32         leaf_count;
	    // number of leaf Records (not nodes)
        UInt32         leaf_head;
	    // first leaf node
        UInt32         leaf_tail;
	    // last leaf node
        UInt16         node_size;
	    // node size of _all_ nodes in this fork
        UInt16         max_key_len;
	    // maximum (or fixed) length of keys in this btree
        UInt32         node_count;
	    // count of all (free and used) nodes in tree
        UInt32         free_nodes;
        UInt16         reserved1;
        UInt32         clump_size;
         // ignored my MacOS used by ?
        UInt8	       btree_type;
         // always 0 for HFS+
        UInt8	       reserved2;
        UInt32         attributes;
	 // see below 
        UInt32         reserved3[16];
} btree_head;

/* BTree attributes */
#define HFSPLUS_BAD_CLOSE            0x01
  // Btree was not properly closed and should be checked
  // not used for HFS+ but reserved
#define HFSPLUS_TREE_BIGKEYS         0x02
  // always set for HFS+
#define HFSPLUS_TREE_VAR_NDXKEY_SIZE 0x04
  // use variable length index nodes, always set for catalog btree,
  // always cleared for extents btree.
#define HFSPLUS_TREE_RESERVED	     0xFFFFFFF8
  // Reserved bits in Attributes
 
#define HFSPLUS_TREE_UNUSED          0xFFFFFFF8

/* Some special File ID numbers */
#define HFSP_POR_CNID             1  /* Parent Of the Root */
#define HFSP_ROOT_CNID            2  /* ROOT directory */
#define HFSP_EXT_CNID             3  /* EXTents B-tree */
#define HFSP_CAT_CNID             4  /* CATalog B-tree */
#define HFSP_BAD_CNID             5  /* BAD blocks file */
#define HFSP_ALLOC_CNID           6  /* ALLOCation file */
#define HFSP_START_CNID           7  /* STARTup file */
#define HFSP_ATTR_CNID            8  /* ATTRibutes file  */
#define HFSP_EXCH_CNID           15  /* ExchangeFiles temp id */
#define HFSP_MIN_CNID		 15  /* Minimum expected value */

/* Unicode String */
typedef struct {
    UInt16		strlen;
    UInt16		name[255];	// unicode characters
} hfsp_unistr255;

/* HFS+ key "superclass" for follwoing keys ...*/
typedef struct {
    UInt16		key_length;	/* excluding length */
    char		data[0];
} hfsp_key;

/* HFS+ catalog entry key */
typedef struct {
    UInt16		key_length;	/* excluding length */
    UInt32		parent_cnid;
    hfsp_unistr255	name;
} hfsp_cat_key;

/* HFS+ extends entry key */
typedef struct {
    UInt16		key_length;	/* excluding length */
    UInt8		fork_type;	/* Seee below */
    UInt8		filler;
    UInt32		file_id;
    UInt32		start_block;	
} hfsp_extent_key;

#define HFSP_EXTENT_DATA    0x00
#define HFSP_EXTENT_RSRC    0xFF

/* The key is followed by a record, an index or some other data */

/* The types of these records are defined as follows */

#define HFSP_FOLDER         0x0001  // entry fo a Folder
#define HFSP_FILE           0x0002  // entry for a File
#define HFSP_FOLDER_THREAD  0x0003  
    // Like '.' in unix, identifies the folder by its id, only
#define HFSP_FILE_THREAD    0x0004  

#define HFSP_THREAD_OFFSET  0x0002  
    // add to create a thread type from a simple type

/* HFS+ folder data (part of an hfsp_cat_entry) */
typedef struct {
    UInt16          flags;		/* no flags defined yet */
    UInt32	    valence;		/* Numer of files and folders contained in folder */
    UInt32	    id;
    UInt32	    create_date;	// GMT
    UInt32	    content_mod_date;	// GMT
    UInt32	    attribute_mod_date;	// GMT
    UInt32	    access_date;	// GMT
    UInt32	    backup_date;	// GMT
    hfsp_perm	    permissions;
    DInfo	    user_info;
    DXInfo	    finder_info;
    UInt32	    text_encoding;
	 // hint fo the finder what encoding to use, unused here
    UInt32         reserved;
} hfsp_cat_folder;

#define HFSP_FOLDER_RESERVED    0xFFFF	// all are reserved :)

/* HFS+ file data (part of a cat_entry) */
typedef struct {
    UInt16          flags;		/* See below */
    UInt32	    reserved1;
    UInt32	    id;
    UInt32	    create_date;
    UInt32	    content_mod_date;
    UInt32	    attribute_mod_date;
    UInt32	    access_date;
    UInt32	    backup_date;
    hfsp_perm	    permissions;
    FInfo           user_info;
    FXInfo	    finder_info;
    UInt32	    text_encoding;
    UInt32	    reserved2;

    hfsp_fork_raw   data_fork;
    hfsp_fork_raw   res_fork;
} hfsp_cat_file;

/* File attribute bits */
#define HFSP_FILE_LOCKED      0x0001
#define HFSP_THREAD_EXISTS    0x0002 /* Always set in HFS+ */
#define HFSP_FILE_RESERVED    0xFFFC

/* HFS+ catalog thread (part of a cat_entry) */
/* In fact this is a almost a hfsp_cat_key */
typedef struct {
    UInt16          reserved;
    UInt32	    parentID;
    hfsp_unistr255   nodeName;
} hfsp_cat_thread;


/* A data record in the catalog tree */
typedef struct {
    UInt16	    type;
    union {
	hfsp_cat_folder folder;
	hfsp_cat_file   file;
	hfsp_cat_thread thread;
    } u;
} hfsp_cat_entry;