xref: /netbsd-src/sys/fs/hfs/hfs.h (revision 003a43716e523ed63d4e8710aa4c0ccbbc3164a9)
1 /*	$NetBSD: hfs.h,v 1.12 2020/07/24 05:26:37 skrll Exp $	*/
2 
3 /*-
4  * Copyright (c) 2005, 2007 The NetBSD Foundation, Inc.
5  * All rights reserved.
6  *
7  * This code is derived from software contributed to The NetBSD Foundation
8  * by Yevgeny Binder and Dieter Baron.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * 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 copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29  * POSSIBILITY OF SUCH DAMAGE.
30  */
31 
32 #ifndef _FS_HFS_HFS_H_
33 #define _FS_HFS_HFS_H_
34 
35 #include <sys/vnode.h>
36 #include <sys/mount.h>
37 
38 #include <miscfs/genfs/genfs_node.h>
39 
40 /* XXX remove before release */
41 /*#define HFS_DEBUG*/
42 
43 #ifdef HFS_DEBUG
44 	#if defined(_KERNEL)
45 		#include "opt_ddb.h"
46 	#endif /* defined(_KERNEL_) */
47 #endif /* HFS_DEBUG */
48 
49 #include <fs/hfs/libhfs.h>
50 
51 /* XXX: make these mount options */
52 #define HFS_DEFAULT_UID	0
53 #define HFS_DEFAULT_GID	0
54 #define HFS_DEFAULT_DIR_MODE	0755
55 #define HFS_DEFAULT_FILE_MODE	0755
56 
57 struct hfs_args {
58 	char *fspec;		/* block special device to mount */
59 };
60 
61 struct hfsmount {
62 	struct mount *hm_mountp;	/* filesystem vfs structure */
63 	dev_t hm_dev;				/* device mounted */
64 	struct vnode *hm_devvp;		/* block device mounted vnode */
65 	hfs_volume hm_vol;			/* essential volume information */
66 };
67 
68 struct hfsnode_key {
69 	hfs_cnid_t hnk_cnid;
70 	uint8_t hnk_fork;
71 };
72 
73 struct hfsnode {
74 	struct genfs_node h_gnode;
75 	struct vnode *h_vnode;		/* vnode associated with this hnode */
76 	struct hfsmount *h_hmp;	/* mount point associated with this hnode */
77 	struct vnode *h_devvp;		/* vnode for block I/O */
78 	dev_t	h_dev;				/* device associated with this hnode */
79 
80 	union {
81 		hfs_file_record_t		file;
82 		hfs_folder_record_t	folder;
83 		struct {
84 			int16_t			rec_type;
85 			uint16_t		flags;
86 			uint32_t		valence;
87 			hfs_cnid_t		cnid;
88 		} u; /* convenience for accessing common record info */
89 	} h_rec; /* catalog record for this hnode */
90 
91 	/*
92 	 * We cache this vnode's parent CNID here upon vnode creation (i.e., during
93 	 * hfs_vop_vget()) for quick access without needing to search the catalog.
94 	 * Note, however, that this value must also be updated whenever this file
95 	 * is moved.
96 	 */
97 	hfs_cnid_t		h_parent;
98 
99 	struct hfsnode_key h_key;
100 #define h_fork	h_key.hnk_fork
101 
102 	long	dummy;	/* FOR DEVELOPMENT ONLY */
103 };
104 
105 typedef struct {
106 	struct vnode* devvp; /* vnode for device I/O */
107 	size_t devblksz; /* device block size (NOT HFS+ allocation block size)*/
108 } hfs_libcb_data; /* custom data used in hfs_volume.cbdata */
109 
110 typedef struct {
111 	kauth_cred_t cred;
112 	struct lwp *l;
113 	struct vnode *devvp;
114 } hfs_libcb_argsopen;
115 
116 typedef struct {
117 	struct lwp *l;
118 } hfs_libcb_argsclose;
119 
120 typedef struct {
121 	kauth_cred_t cred;
122 	struct lwp *l;
123 } hfs_libcb_argsread;
124 
125 #ifdef _KERNEL
126 #include <sys/malloc.h>
127 
128 MALLOC_DECLARE(M_HFSMNT);	/* defined in hfs_vfsops.c */
129 
130 /*
131  * Convenience macros
132  */
133 
134 /* Convert mount ptr to hfsmount ptr. */
135 #define VFSTOHFS(mp)    ((struct hfsmount *)((mp)->mnt_data))
136 
137 /* Convert between vnode ptrs and hfsnode ptrs. */
138 #define VTOH(vp)    ((struct hfsnode *)(vp)->v_data)
139 #define	HTOV(hp)	((hp)->h_vnode)
140 
141 /* Get volume's allocation block size given a vnode ptr */
142 #define HFS_BLOCKSIZE(vp)    (VTOH(vp)->h_hmp->hm_vol.vh.block_size)
143 
144 
145 /* Convert special device major/minor */
146 #define HFS_CONVERT_RDEV(x)	makedev((x)>>24, (x)&0xffffff)
147 
148 /*
149  * Global variables
150  */
151 
152 extern const struct vnodeopv_desc hfs_vnodeop_opv_desc;
153 extern const struct vnodeopv_desc hfs_specop_opv_desc;
154 extern const struct vnodeopv_desc hfs_fifoop_opv_desc;
155 extern int (**hfs_specop_p) (void *);
156 extern int (**hfs_fifoop_p) (void *);
157 extern struct pool hfs_node_pool;
158 
159 
160 /*
161  * Function prototypes
162  */
163 
164 /* hfs_subr.c */
165 void hfs_vinit (struct mount *, int (**)(void *), int (**)(void *),
166 		 struct vnode **);
167 int hfs_pread(struct vnode*, void*, size_t, uint64_t, uint64_t, kauth_cred_t);
168 char* hfs_unicode_to_ascii(const unichar_t*, uint8_t, char*);
169 unichar_t* hfs_ascii_to_unicode(const char*, uint8_t, unichar_t*);
170 
171 void hfs_time_to_timespec(uint32_t, struct timespec *);
172 enum vtype hfs_catalog_keyed_record_vtype(const hfs_catalog_keyed_record_t *);
173 
174 void hfs_libcb_error(const char*, const char*, int, va_list);
175 void* hfs_libcb_malloc(size_t, hfs_callback_args*);
176 void* hfs_libcb_realloc(void*, size_t, hfs_callback_args*);
177 void hfs_libcb_free(void*, hfs_callback_args*);
178 int hfs_libcb_opendev(hfs_volume*, const char*, hfs_callback_args*);
179 void hfs_libcb_closedev(hfs_volume*, hfs_callback_args*);
180 int hfs_libcb_read(hfs_volume*, void*, uint64_t, uint64_t,
181 	hfs_callback_args*);
182 
183 uint16_t be16tohp(void**);
184 uint32_t be32tohp(void**);
185 uint64_t be64tohp(void**);
186 
187 
188 /* hfs_vfsops.c */
189 VFS_PROTOS(hfs);
190 
191 int hfs_mountfs (struct vnode *, struct mount *, struct lwp *, const char *);
192 int hfs_vget_internal(struct mount *, ino_t, uint8_t, struct vnode **);
193 
194 /* hfs_vnops.c */
195 extern int (**hfs_vnodeop_p) (void *);
196 
197 #endif /* _KERNEL */
198 
199 #endif /* !_FS_HFS_HFS_H_ */
200