xref: /illumos-gate/usr/src/lib/libzpool/common/sys/zfs_context.h (revision 0a0551200ecbcd4f1b17560acaeeb7b6c8b0090e)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 /*
22  * Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
23  * Copyright 2011 Nexenta Systems, Inc.  All rights reserved.
24  * Copyright (c) 2012, 2016 by Delphix. All rights reserved.
25  * Copyright (c) 2012, Joyent, Inc. All rights reserved.
26  */
27 
28 #ifndef _SYS_ZFS_CONTEXT_H
29 #define	_SYS_ZFS_CONTEXT_H
30 
31 #ifdef	__cplusplus
32 extern "C" {
33 #endif
34 
35 #define	_SYS_MUTEX_H
36 #define	_SYS_RWLOCK_H
37 #define	_SYS_CONDVAR_H
38 #define	_SYS_SYSTM_H
39 #define	_SYS_T_LOCK_H
40 #define	_SYS_VNODE_H
41 #define	_SYS_VFS_H
42 #define	_SYS_SUNDDI_H
43 #define	_SYS_CALLB_H
44 
45 #include <stdio.h>
46 #include <stdlib.h>
47 #include <stddef.h>
48 #include <stdarg.h>
49 #include <fcntl.h>
50 #include <unistd.h>
51 #include <errno.h>
52 #include <string.h>
53 #include <strings.h>
54 #include <synch.h>
55 #include <thread.h>
56 #include <assert.h>
57 #include <alloca.h>
58 #include <umem.h>
59 #include <limits.h>
60 #include <atomic.h>
61 #include <dirent.h>
62 #include <time.h>
63 #include <procfs.h>
64 #include <pthread.h>
65 #include <setjmp.h>
66 #include <sys/debug.h>
67 #include <libsysevent.h>
68 #include <sys/note.h>
69 #include <sys/types.h>
70 #include <sys/cred.h>
71 #include <sys/sysmacros.h>
72 #include <sys/bitmap.h>
73 #include <sys/resource.h>
74 #include <sys/byteorder.h>
75 #include <sys/list.h>
76 #include <sys/uio.h>
77 #include <sys/zfs_debug.h>
78 #include <sys/sdt.h>
79 #include <sys/kstat.h>
80 #include <sys/u8_textprep.h>
81 #include <sys/sysevent/eventdefs.h>
82 #include <sys/sysevent/dev.h>
83 #include <sys/sunddi.h>
84 #include <sys/debug.h>
85 #include "zfs.h"
86 
87 /*
88  * Debugging
89  */
90 
91 /*
92  * Note that we are not using the debugging levels.
93  */
94 
95 #define	CE_CONT		0	/* continuation		*/
96 #define	CE_NOTE		1	/* notice		*/
97 #define	CE_WARN		2	/* warning		*/
98 #define	CE_PANIC	3	/* panic		*/
99 #define	CE_IGNORE	4	/* print nothing	*/
100 
101 /*
102  * ZFS debugging
103  */
104 
105 #ifdef ZFS_DEBUG
106 extern void dprintf_setup(int *argc, char **argv);
107 #endif /* ZFS_DEBUG */
108 
109 extern void cmn_err(int, const char *, ...);
110 extern void vcmn_err(int, const char *, __va_list);
111 extern void panic(const char *, ...)  __NORETURN;
112 extern void vpanic(const char *, __va_list)  __NORETURN;
113 
114 #define	fm_panic	panic
115 
116 extern int aok;
117 
118 /*
119  * DTrace SDT probes have different signatures in userland than they do in
120  * the kernel.  If they're being used in kernel code, re-define them out of
121  * existence for their counterparts in libzpool.
122  *
123  * Here's an example of how to use the set-error probes in userland:
124  * zfs$target:::set-error /arg0 == EBUSY/ {stack();}
125  *
126  * Here's an example of how to use DTRACE_PROBE probes in userland:
127  * If there is a probe declared as follows:
128  * DTRACE_PROBE2(zfs__probe_name, uint64_t, blkid, dnode_t *, dn);
129  * Then you can use it as follows:
130  * zfs$target:::probe2 /copyinstr(arg0) == "zfs__probe_name"/
131  *     {printf("%u %p\n", arg1, arg2);}
132  */
133 
134 #ifdef DTRACE_PROBE
135 #undef	DTRACE_PROBE
136 #endif	/* DTRACE_PROBE */
137 #define	DTRACE_PROBE(a) \
138 	ZFS_PROBE0(#a)
139 
140 #ifdef DTRACE_PROBE1
141 #undef	DTRACE_PROBE1
142 #endif	/* DTRACE_PROBE1 */
143 #define	DTRACE_PROBE1(a, b, c) \
144 	ZFS_PROBE1(#a, (unsigned long)c)
145 
146 #ifdef DTRACE_PROBE2
147 #undef	DTRACE_PROBE2
148 #endif	/* DTRACE_PROBE2 */
149 #define	DTRACE_PROBE2(a, b, c, d, e) \
150 	ZFS_PROBE2(#a, (unsigned long)c, (unsigned long)e)
151 
152 #ifdef DTRACE_PROBE3
153 #undef	DTRACE_PROBE3
154 #endif	/* DTRACE_PROBE3 */
155 #define	DTRACE_PROBE3(a, b, c, d, e, f, g) \
156 	ZFS_PROBE3(#a, (unsigned long)c, (unsigned long)e, (unsigned long)g)
157 
158 #ifdef DTRACE_PROBE4
159 #undef	DTRACE_PROBE4
160 #endif	/* DTRACE_PROBE4 */
161 #define	DTRACE_PROBE4(a, b, c, d, e, f, g, h, i) \
162 	ZFS_PROBE4(#a, (unsigned long)c, (unsigned long)e, (unsigned long)g, \
163 	(unsigned long)i)
164 
165 /*
166  * We use the comma operator so that this macro can be used without much
167  * additional code.  For example, "return (EINVAL);" becomes
168  * "return (SET_ERROR(EINVAL));".  Note that the argument will be evaluated
169  * twice, so it should not have side effects (e.g. something like:
170  * "return (SET_ERROR(log_error(EINVAL, info)));" would log the error twice).
171  */
172 #define	SET_ERROR(err) (ZFS_SET_ERROR(err), err)
173 
174 /*
175  * Threads
176  */
177 #define	curthread	((void *)(uintptr_t)thr_self())
178 
179 #define	kpreempt(x)	yield()
180 
181 typedef struct kthread kthread_t;
182 
183 #define	thread_create(stk, stksize, func, arg, len, pp, state, pri)	\
184 	zk_thread_create(func, arg, len)
185 #define	thread_exit() thr_exit(NULL)
186 #define	thread_join(t)	panic("libzpool cannot join threads")
187 
188 #define	newproc(f, a, cid, pri, ctp, pid)	(ENOSYS)
189 
190 /* in libzpool, p0 exists only to have its address taken */
191 struct proc {
192 	uintptr_t	this_is_never_used_dont_dereference_it;
193 };
194 
195 extern struct proc p0;
196 #define	curproc		(&p0)
197 
198 #define	PS_NONE		-1
199 
200 extern kthread_t *zk_thread_create(void (*func)(), void *arg, uint64_t len);
201 
202 #define	issig(why)	(FALSE)
203 #define	ISSIG(thr, why)	(FALSE)
204 
205 /*
206  * Mutexes
207  */
208 typedef struct kmutex {
209 	void		*m_owner;
210 	boolean_t	initialized;
211 	mutex_t		m_lock;
212 } kmutex_t;
213 
214 #define	MUTEX_DEFAULT	USYNC_THREAD
215 #undef	MUTEX_HELD
216 #undef	MUTEX_NOT_HELD
217 #define	MUTEX_HELD(m) _mutex_held(&(m)->m_lock)
218 #define	MUTEX_NOT_HELD(m) (!MUTEX_HELD(m))
219 
220 /*
221  * Argh -- we have to get cheesy here because the kernel and userland
222  * have different signatures for the same routine.
223  */
224 extern int _mutex_init(mutex_t *mp, int type, void *arg);
225 extern int _mutex_destroy(mutex_t *mp);
226 
227 #define	mutex_init(mp, b, c, d)		zmutex_init((kmutex_t *)(mp))
228 #define	mutex_destroy(mp)		zmutex_destroy((kmutex_t *)(mp))
229 #define	mutex_enter(mp)			zmutex_enter(mp)
230 #define	mutex_exit(mp)			zmutex_exit(mp)
231 
232 extern void zmutex_init(kmutex_t *mp);
233 extern void zmutex_destroy(kmutex_t *mp);
234 extern void zmutex_enter(kmutex_t *mp);
235 extern void zmutex_exit(kmutex_t *mp);
236 extern int mutex_tryenter(kmutex_t *mp);
237 extern void *mutex_owner(kmutex_t *mp);
238 
239 /*
240  * RW locks
241  */
242 typedef struct krwlock {
243 	void		*rw_owner;
244 	boolean_t	initialized;
245 	rwlock_t	rw_lock;
246 } krwlock_t;
247 
248 typedef int krw_t;
249 
250 #define	RW_READER	0
251 #define	RW_WRITER	1
252 #define	RW_DEFAULT	USYNC_THREAD
253 
254 #undef RW_READ_HELD
255 #define	RW_READ_HELD(x)		_rw_read_held(&(x)->rw_lock)
256 
257 #undef RW_WRITE_HELD
258 #define	RW_WRITE_HELD(x)	_rw_write_held(&(x)->rw_lock)
259 
260 #undef RW_LOCK_HELD
261 #define	RW_LOCK_HELD(x)		(RW_READ_HELD(x) || RW_WRITE_HELD(x))
262 
263 extern void rw_init(krwlock_t *rwlp, char *name, int type, void *arg);
264 extern void rw_destroy(krwlock_t *rwlp);
265 extern void rw_enter(krwlock_t *rwlp, krw_t rw);
266 extern int rw_tryenter(krwlock_t *rwlp, krw_t rw);
267 extern int rw_tryupgrade(krwlock_t *rwlp);
268 extern void rw_exit(krwlock_t *rwlp);
269 #define	rw_downgrade(rwlp) do { } while (0)
270 
271 extern uid_t crgetuid(cred_t *cr);
272 extern uid_t crgetruid(cred_t *cr);
273 extern gid_t crgetgid(cred_t *cr);
274 extern int crgetngroups(cred_t *cr);
275 extern gid_t *crgetgroups(cred_t *cr);
276 
277 /*
278  * Condition variables
279  */
280 typedef cond_t kcondvar_t;
281 
282 #define	CV_DEFAULT	USYNC_THREAD
283 #define	CALLOUT_FLAG_ABSOLUTE	0x2
284 
285 extern void cv_init(kcondvar_t *cv, char *name, int type, void *arg);
286 extern void cv_destroy(kcondvar_t *cv);
287 extern void cv_wait(kcondvar_t *cv, kmutex_t *mp);
288 extern clock_t cv_timedwait(kcondvar_t *cv, kmutex_t *mp, clock_t abstime);
289 extern clock_t cv_timedwait_hires(kcondvar_t *cvp, kmutex_t *mp, hrtime_t tim,
290     hrtime_t res, int flag);
291 extern void cv_signal(kcondvar_t *cv);
292 extern void cv_broadcast(kcondvar_t *cv);
293 
294 /*
295  * Thread-specific data
296  */
297 #define	tsd_get(k) pthread_getspecific(k)
298 #define	tsd_set(k, v) pthread_setspecific(k, v)
299 #define	tsd_create(kp, d) pthread_key_create(kp, d)
300 #define	tsd_destroy(kp) /* nothing */
301 
302 /*
303  * kstat creation, installation and deletion
304  */
305 extern kstat_t *kstat_create(const char *, int,
306     const char *, const char *, uchar_t, ulong_t, uchar_t);
307 extern void kstat_named_init(kstat_named_t *, const char *, uchar_t);
308 extern void kstat_install(kstat_t *);
309 extern void kstat_delete(kstat_t *);
310 extern void kstat_waitq_enter(kstat_io_t *);
311 extern void kstat_waitq_exit(kstat_io_t *);
312 extern void kstat_runq_enter(kstat_io_t *);
313 extern void kstat_runq_exit(kstat_io_t *);
314 extern void kstat_waitq_to_runq(kstat_io_t *);
315 extern void kstat_runq_back_to_waitq(kstat_io_t *);
316 
317 /*
318  * Kernel memory
319  */
320 #define	KM_SLEEP		UMEM_NOFAIL
321 #define	KM_PUSHPAGE		KM_SLEEP
322 #define	KM_NOSLEEP		UMEM_DEFAULT
323 #define	KM_NORMALPRI		0	/* not needed with UMEM_DEFAULT */
324 #define	KMC_NODEBUG		UMC_NODEBUG
325 #define	KMC_NOTOUCH		0	/* not needed for userland caches */
326 #define	kmem_alloc(_s, _f)	umem_alloc(_s, _f)
327 #define	kmem_zalloc(_s, _f)	umem_zalloc(_s, _f)
328 #define	kmem_free(_b, _s)	umem_free(_b, _s)
329 #define	kmem_cache_create(_a, _b, _c, _d, _e, _f, _g, _h, _i) \
330 	umem_cache_create(_a, _b, _c, _d, _e, _f, _g, _h, _i)
331 #define	kmem_cache_destroy(_c)	umem_cache_destroy(_c)
332 #define	kmem_cache_alloc(_c, _f) umem_cache_alloc(_c, _f)
333 #define	kmem_cache_free(_c, _b)	umem_cache_free(_c, _b)
334 #define	kmem_debugging()	0
335 #define	kmem_cache_reap_now(_c)		/* nothing */
336 #define	kmem_cache_set_move(_c, _cb)	/* nothing */
337 #define	vmem_qcache_reap(_v)		/* nothing */
338 #define	POINTER_INVALIDATE(_pp)		/* nothing */
339 #define	POINTER_IS_VALID(_p)	0
340 
341 extern vmem_t *zio_arena;
342 
343 typedef umem_cache_t kmem_cache_t;
344 
345 typedef enum kmem_cbrc {
346 	KMEM_CBRC_YES,
347 	KMEM_CBRC_NO,
348 	KMEM_CBRC_LATER,
349 	KMEM_CBRC_DONT_NEED,
350 	KMEM_CBRC_DONT_KNOW
351 } kmem_cbrc_t;
352 
353 /*
354  * Task queues
355  */
356 typedef struct taskq taskq_t;
357 typedef uintptr_t taskqid_t;
358 typedef void (task_func_t)(void *);
359 
360 typedef struct taskq_ent {
361 	struct taskq_ent	*tqent_next;
362 	struct taskq_ent	*tqent_prev;
363 	task_func_t		*tqent_func;
364 	void			*tqent_arg;
365 	uintptr_t		tqent_flags;
366 } taskq_ent_t;
367 
368 #define	TQENT_FLAG_PREALLOC	0x1	/* taskq_dispatch_ent used */
369 
370 #define	TASKQ_PREPOPULATE	0x0001
371 #define	TASKQ_CPR_SAFE		0x0002	/* Use CPR safe protocol */
372 #define	TASKQ_DYNAMIC		0x0004	/* Use dynamic thread scheduling */
373 #define	TASKQ_THREADS_CPU_PCT	0x0008	/* Scale # threads by # cpus */
374 #define	TASKQ_DC_BATCH		0x0010	/* Mark threads as batch */
375 
376 #define	TQ_SLEEP	KM_SLEEP	/* Can block for memory */
377 #define	TQ_NOSLEEP	KM_NOSLEEP	/* cannot block for memory; may fail */
378 #define	TQ_NOQUEUE	0x02		/* Do not enqueue if can't dispatch */
379 #define	TQ_FRONT	0x08		/* Queue in front */
380 
381 
382 extern taskq_t *system_taskq;
383 
384 extern taskq_t	*taskq_create(const char *, int, pri_t, int, int, uint_t);
385 #define	taskq_create_proc(a, b, c, d, e, p, f) \
386 	    (taskq_create(a, b, c, d, e, f))
387 #define	taskq_create_sysdc(a, b, d, e, p, dc, f) \
388 	    (taskq_create(a, b, maxclsyspri, d, e, f))
389 extern taskqid_t taskq_dispatch(taskq_t *, task_func_t, void *, uint_t);
390 extern void	taskq_dispatch_ent(taskq_t *, task_func_t, void *, uint_t,
391     taskq_ent_t *);
392 extern void	taskq_destroy(taskq_t *);
393 extern void	taskq_wait(taskq_t *);
394 extern int	taskq_member(taskq_t *, void *);
395 extern void	system_taskq_init(void);
396 extern void	system_taskq_fini(void);
397 
398 #define	XVA_MAPSIZE	3
399 #define	XVA_MAGIC	0x78766174
400 
401 /*
402  * vnodes
403  */
404 typedef struct vnode {
405 	uint64_t	v_size;
406 	int		v_fd;
407 	char		*v_path;
408 	int		v_dump_fd;
409 } vnode_t;
410 
411 extern char *vn_dumpdir;
412 #define	AV_SCANSTAMP_SZ	32		/* length of anti-virus scanstamp */
413 
414 typedef struct xoptattr {
415 	timestruc_t	xoa_createtime;	/* Create time of file */
416 	uint8_t		xoa_archive;
417 	uint8_t		xoa_system;
418 	uint8_t		xoa_readonly;
419 	uint8_t		xoa_hidden;
420 	uint8_t		xoa_nounlink;
421 	uint8_t		xoa_immutable;
422 	uint8_t		xoa_appendonly;
423 	uint8_t		xoa_nodump;
424 	uint8_t		xoa_settable;
425 	uint8_t		xoa_opaque;
426 	uint8_t		xoa_av_quarantined;
427 	uint8_t		xoa_av_modified;
428 	uint8_t		xoa_av_scanstamp[AV_SCANSTAMP_SZ];
429 	uint8_t		xoa_reparse;
430 	uint8_t		xoa_offline;
431 	uint8_t		xoa_sparse;
432 } xoptattr_t;
433 
434 typedef struct vattr {
435 	uint_t		va_mask;	/* bit-mask of attributes */
436 	u_offset_t	va_size;	/* file size in bytes */
437 } vattr_t;
438 
439 
440 typedef struct xvattr {
441 	vattr_t		xva_vattr;	/* Embedded vattr structure */
442 	uint32_t	xva_magic;	/* Magic Number */
443 	uint32_t	xva_mapsize;	/* Size of attr bitmap (32-bit words) */
444 	uint32_t	*xva_rtnattrmapp;	/* Ptr to xva_rtnattrmap[] */
445 	uint32_t	xva_reqattrmap[XVA_MAPSIZE];	/* Requested attrs */
446 	uint32_t	xva_rtnattrmap[XVA_MAPSIZE];	/* Returned attrs */
447 	xoptattr_t	xva_xoptattrs;	/* Optional attributes */
448 } xvattr_t;
449 
450 typedef struct vsecattr {
451 	uint_t		vsa_mask;	/* See below */
452 	int		vsa_aclcnt;	/* ACL entry count */
453 	void		*vsa_aclentp;	/* pointer to ACL entries */
454 	int		vsa_dfaclcnt;	/* default ACL entry count */
455 	void		*vsa_dfaclentp;	/* pointer to default ACL entries */
456 	size_t		vsa_aclentsz;	/* ACE size in bytes of vsa_aclentp */
457 } vsecattr_t;
458 
459 #define	AT_TYPE		0x00001
460 #define	AT_MODE		0x00002
461 #define	AT_UID		0x00004
462 #define	AT_GID		0x00008
463 #define	AT_FSID		0x00010
464 #define	AT_NODEID	0x00020
465 #define	AT_NLINK	0x00040
466 #define	AT_SIZE		0x00080
467 #define	AT_ATIME	0x00100
468 #define	AT_MTIME	0x00200
469 #define	AT_CTIME	0x00400
470 #define	AT_RDEV		0x00800
471 #define	AT_BLKSIZE	0x01000
472 #define	AT_NBLOCKS	0x02000
473 #define	AT_SEQ		0x08000
474 #define	AT_XVATTR	0x10000
475 
476 #define	CRCREAT		0
477 
478 extern int fop_getattr(vnode_t *vp, vattr_t *vap);
479 
480 #define	VOP_CLOSE(vp, f, c, o, cr, ct)	0
481 #define	VOP_PUTPAGE(vp, of, sz, fl, cr, ct)	0
482 #define	VOP_GETATTR(vp, vap, fl, cr, ct)  fop_getattr((vp), (vap));
483 
484 #define	VOP_FSYNC(vp, f, cr, ct)	fsync((vp)->v_fd)
485 
486 #define	VN_RELE(vp)	vn_close(vp)
487 
488 extern int vn_open(char *path, int x1, int oflags, int mode, vnode_t **vpp,
489     int x2, int x3);
490 extern int vn_openat(char *path, int x1, int oflags, int mode, vnode_t **vpp,
491     int x2, int x3, vnode_t *vp, int fd);
492 extern int vn_rdwr(int uio, vnode_t *vp, void *addr, ssize_t len,
493     offset_t offset, int x1, int x2, rlim64_t x3, void *x4, ssize_t *residp);
494 extern void vn_close(vnode_t *vp);
495 
496 #define	vn_remove(path, x1, x2)		remove(path)
497 #define	vn_rename(from, to, seg)	rename((from), (to))
498 #define	vn_is_readonly(vp)		B_FALSE
499 
500 extern vnode_t *rootdir;
501 
502 #include <sys/file.h>		/* for FREAD, FWRITE, etc */
503 
504 /*
505  * Random stuff
506  */
507 #define	ddi_get_lbolt()		(gethrtime() >> 23)
508 #define	ddi_get_lbolt64()	(gethrtime() >> 23)
509 #define	hz	119	/* frequency when using gethrtime() >> 23 for lbolt */
510 
511 extern void delay(clock_t ticks);
512 
513 #define	SEC_TO_TICK(sec)	((sec) * hz)
514 #define	NSEC_TO_TICK(usec)	((usec) / (NANOSEC / hz))
515 
516 #define	gethrestime_sec() time(NULL)
517 #define	gethrestime(t) \
518 	do {\
519 		(t)->tv_sec = gethrestime_sec();\
520 		(t)->tv_nsec = 0;\
521 	} while (0);
522 
523 #define	max_ncpus	64
524 #define	boot_ncpus	(sysconf(_SC_NPROCESSORS_ONLN))
525 
526 #define	minclsyspri	60
527 #define	maxclsyspri	99
528 
529 #define	CPU_SEQID	(thr_self() & (max_ncpus - 1))
530 
531 #define	kcred		NULL
532 #define	CRED()		NULL
533 
534 #define	ptob(x)		((x) * PAGESIZE)
535 
536 extern uint64_t physmem;
537 
538 extern int highbit64(uint64_t i);
539 extern int random_get_bytes(uint8_t *ptr, size_t len);
540 extern int random_get_pseudo_bytes(uint8_t *ptr, size_t len);
541 
542 extern void kernel_init(int);
543 extern void kernel_fini(void);
544 
545 struct spa;
546 extern void nicenum(uint64_t num, char *buf, size_t);
547 extern void show_pool_stats(struct spa *);
548 extern int set_global_var(char *arg);
549 
550 typedef struct callb_cpr {
551 	kmutex_t	*cc_lockp;
552 } callb_cpr_t;
553 
554 #define	CALLB_CPR_INIT(cp, lockp, func, name)	{		\
555 	(cp)->cc_lockp = lockp;					\
556 }
557 
558 #define	CALLB_CPR_SAFE_BEGIN(cp) {				\
559 	ASSERT(MUTEX_HELD((cp)->cc_lockp));			\
560 }
561 
562 #define	CALLB_CPR_SAFE_END(cp, lockp) {				\
563 	ASSERT(MUTEX_HELD((cp)->cc_lockp));			\
564 }
565 
566 #define	CALLB_CPR_EXIT(cp) {					\
567 	ASSERT(MUTEX_HELD((cp)->cc_lockp));			\
568 	mutex_exit((cp)->cc_lockp);				\
569 }
570 
571 #define	zone_dataset_visible(x, y)	(1)
572 #define	INGLOBALZONE(z)			(1)
573 
574 extern char *kmem_asprintf(const char *fmt, ...);
575 #define	strfree(str) kmem_free((str), strlen(str) + 1)
576 
577 /*
578  * Hostname information
579  */
580 extern char hw_serial[];	/* for userland-emulated hostid access */
581 extern int ddi_strtoul(const char *str, char **nptr, int base,
582     unsigned long *result);
583 
584 extern int ddi_strtoull(const char *str, char **nptr, int base,
585     u_longlong_t *result);
586 
587 /* ZFS Boot Related stuff. */
588 
589 struct _buf {
590 	intptr_t	_fd;
591 };
592 
593 struct bootstat {
594 	uint64_t st_size;
595 };
596 
597 typedef struct ace_object {
598 	uid_t		a_who;
599 	uint32_t	a_access_mask;
600 	uint16_t	a_flags;
601 	uint16_t	a_type;
602 	uint8_t		a_obj_type[16];
603 	uint8_t		a_inherit_obj_type[16];
604 } ace_object_t;
605 
606 
607 #define	ACE_ACCESS_ALLOWED_OBJECT_ACE_TYPE	0x05
608 #define	ACE_ACCESS_DENIED_OBJECT_ACE_TYPE	0x06
609 #define	ACE_SYSTEM_AUDIT_OBJECT_ACE_TYPE	0x07
610 #define	ACE_SYSTEM_ALARM_OBJECT_ACE_TYPE	0x08
611 
612 extern struct _buf *kobj_open_file(char *name);
613 extern int kobj_read_file(struct _buf *file, char *buf, unsigned size,
614     unsigned off);
615 extern void kobj_close_file(struct _buf *file);
616 extern int kobj_get_filesize(struct _buf *file, uint64_t *size);
617 extern int zfs_secpolicy_snapshot_perms(const char *name, cred_t *cr);
618 extern int zfs_secpolicy_rename_perms(const char *from, const char *to,
619     cred_t *cr);
620 extern int zfs_secpolicy_destroy_perms(const char *name, cred_t *cr);
621 extern zoneid_t getzoneid(void);
622 
623 /* SID stuff */
624 typedef struct ksiddomain {
625 	uint_t	kd_ref;
626 	uint_t	kd_len;
627 	char	*kd_name;
628 } ksiddomain_t;
629 
630 ksiddomain_t *ksid_lookupdomain(const char *);
631 void ksiddomain_rele(ksiddomain_t *);
632 
633 #define	DDI_SLEEP	KM_SLEEP
634 #define	ddi_log_sysevent(_a, _b, _c, _d, _e, _f, _g) \
635 	sysevent_post_event(_c, _d, _b, "libzpool", _e, _f)
636 
637 /*
638  * Cyclic information
639  */
640 extern kmutex_t cpu_lock;
641 
642 typedef uintptr_t cyclic_id_t;
643 typedef uint16_t cyc_level_t;
644 typedef void (*cyc_func_t)(void *);
645 
646 #define	CY_LOW_LEVEL	0
647 #define	CY_INFINITY	INT64_MAX
648 #define	CYCLIC_NONE	((cyclic_id_t)0)
649 
650 typedef struct cyc_time {
651 	hrtime_t cyt_when;
652 	hrtime_t cyt_interval;
653 } cyc_time_t;
654 
655 typedef struct cyc_handler {
656 	cyc_func_t cyh_func;
657 	void *cyh_arg;
658 	cyc_level_t cyh_level;
659 } cyc_handler_t;
660 
661 extern cyclic_id_t cyclic_add(cyc_handler_t *, cyc_time_t *);
662 extern void cyclic_remove(cyclic_id_t);
663 extern int cyclic_reprogram(cyclic_id_t, hrtime_t);
664 
665 /*
666  * Buf structure
667  */
668 #define	B_BUSY		0x0001
669 #define	B_DONE		0x0002
670 #define	B_ERROR		0x0004
671 #define	B_READ		0x0040	/* read when I/O occurs */
672 #define	B_WRITE		0x0100	/* non-read pseudo-flag */
673 
674 typedef struct buf {
675 	int	b_flags;
676 	size_t b_bcount;
677 	union {
678 		caddr_t b_addr;
679 	} b_un;
680 
681 	lldaddr_t	_b_blkno;
682 #define	b_lblkno	_b_blkno._f
683 	size_t	b_resid;
684 	size_t	b_bufsize;
685 	int	(*b_iodone)(struct buf *);
686 	int	b_error;
687 	void	*b_private;
688 } buf_t;
689 
690 extern void bioinit(buf_t *);
691 extern void biodone(buf_t *);
692 extern void bioerror(buf_t *, int);
693 extern int geterror(buf_t *);
694 
695 #ifdef	__cplusplus
696 }
697 #endif
698 
699 #endif	/* _SYS_ZFS_CONTEXT_H */
700