1/*	$NetBSD: ukfs.h,v 1.12 2009/11/05 14:22:54 pooka Exp $	*/
2
3/*
4 * Copyright (c) 2007, 2008, 2009  Antti Kantee.  All Rights Reserved.
5 *
6 * Development of this software was supported by the
7 * Finnish Cultural Foundation.
8 *
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions
11 * are met:
12 * 1. Redistributions of source code must retain the above copyright
13 *    notice, this list of conditions and the following disclaimer.
14 * 2. Redistributions in binary form must reproduce the above copyright
15 *    notice, this list of conditions and the following disclaimer in the
16 *    documentation and/or other materials provided with the distribution.
17 *
18 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
19 * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
20 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
21 * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
24 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 * SUCH DAMAGE.
29 */
30
31#ifndef _RUMP_UKFS_H_
32#define _RUMP_UKFS_H_
33
34#include <sys/types.h>
35
36#include <stdint.h>
37
38/* don't include NetBSD <sys/header.h> for portability */
39struct vnode;
40struct stat;
41struct timeval;
42
43struct ukfs;
44struct ukfs_dircookie;
45struct ukfs_part;
46
47#define UKFS_DEFAULTMP "/ukfs"
48
49#define UKFS_RELFLAG_NOUNMOUNT	0x01
50#define UKFS_RELFLAG_FORCE	0x02
51
52#define UKFS_VERSION	002 /* secret ukfs 002 */
53#define	ukfs_init()	_ukfs_init(UKFS_VERSION)
54
55__BEGIN_DECLS
56
57int		_ukfs_init(int);
58struct ukfs	*ukfs_mount(const char *, const char *, const char *,
59			    int, void *, size_t);
60struct ukfs	*ukfs_mount_disk(const char *, const char *, struct ukfs_part *,
61				 const char *, int, void *, size_t);
62int		ukfs_release(struct ukfs *, int);
63
64int		ukfs_opendir(struct ukfs *, const char *,
65			     struct ukfs_dircookie **);
66int		ukfs_getdents(struct ukfs *, const char *, off_t *,
67			      uint8_t *, size_t);
68int		ukfs_getdents_cookie(struct ukfs *, struct ukfs_dircookie *,
69				     off_t *, uint8_t *, size_t);
70int		ukfs_closedir(struct ukfs *, struct ukfs_dircookie *);
71
72int		ukfs_open(struct ukfs *, const char *, int);
73ssize_t		ukfs_read(struct ukfs *, const char *, off_t,
74			      uint8_t *, size_t);
75ssize_t		ukfs_read_fd(struct ukfs *, int, off_t, uint8_t *, size_t);
76ssize_t		ukfs_write(struct ukfs *, const char *, off_t,
77			       uint8_t *, size_t);
78ssize_t		ukfs_write_fd(struct ukfs *, int, off_t, uint8_t *, size_t,int);
79int		ukfs_close(struct ukfs *, int);
80
81ssize_t		ukfs_readlink(struct ukfs *, const char *, char *, size_t);
82
83int		ukfs_create(struct ukfs *, const char *, mode_t);
84int		ukfs_mkdir(struct ukfs *, const char *, mode_t);
85int		ukfs_mknod(struct ukfs *, const char *, mode_t, dev_t);
86int		ukfs_mkfifo(struct ukfs *, const char *, mode_t);
87int		ukfs_symlink(struct ukfs *, const char *, const char *);
88
89int		ukfs_remove(struct ukfs *, const char *);
90int		ukfs_rmdir(struct ukfs *, const char *);
91
92int		ukfs_link(struct ukfs *, const char *, const char *);
93int		ukfs_rename(struct ukfs *, const char *, const char *);
94
95int		ukfs_chdir(struct ukfs *, const char *);
96
97int		ukfs_stat(struct ukfs *, const char *, struct stat *);
98int		ukfs_lstat(struct ukfs *, const char *, struct stat *);
99
100int		ukfs_chmod(struct ukfs *, const char *, mode_t);
101int		ukfs_lchmod(struct ukfs *, const char *, mode_t);
102int		ukfs_chown(struct ukfs *, const char *, uid_t, gid_t);
103int		ukfs_lchown(struct ukfs *, const char *, uid_t, gid_t);
104int		ukfs_chflags(struct ukfs *, const char *, u_long);
105int		ukfs_lchflags(struct ukfs *, const char *, u_long);
106
107int		ukfs_utimes(struct ukfs *, const char *,
108			    const struct timeval *);
109int		ukfs_lutimes(struct ukfs *, const char *,
110			     const struct timeval *);
111
112struct mount	*ukfs_getmp(struct ukfs *);
113struct vnode	*ukfs_getrvp(struct ukfs *);
114void		ukfs_setspecific(struct ukfs *, void *);
115void *		ukfs_getspecific(struct ukfs *);
116
117/* partition magic in device names */
118extern struct ukfs_part *ukfs_part_none;
119extern struct ukfs_part *ukfs_part_na;
120#define UKFS_PARTITION_SCANMAGIC "%PART:" /* deprecated */
121
122#define UKFS_DISKLABEL_SCANMAGIC "%DISKLABEL:"
123#define UKFS_DISKLABEL_MAGICLEN (sizeof(UKFS_DISKLABEL_SCANMAGIC "a%")-1)
124
125#define UKFS_OFFSET_SCANMAGIC "%OFFSET:"
126#define UKFS_OFFSET_MINLEN (sizeof(UKFS_OFFSET_SCANMAGIC "512,512%")-1)
127
128#define UKFS_DEVICE_MAXSTR 128 /* unexact science ... */
129#define UKFS_DEVICE_MAXPATHLEN (MAXPATHLEN+UKFS_DEVICE_MAXSTR)
130
131#define UKFS_DEVICE_ARGVPROBE(part)					\
132do {									\
133	if (argc >= 3)							\
134		if (ukfs_part_probe(argv[argc-2], part) == -1)	\
135			err(1, "ukfs_part_probe");			\
136} while (/*CONSTCOND*/0)
137
138int		ukfs_part_probe(char *, struct ukfs_part **);
139void		ukfs_part_release(struct ukfs_part *);
140int		ukfs_part_tostring(struct ukfs_part *, char *, size_t);
141
142/* dynamic loading of library modules */
143int		ukfs_modload(const char *);
144int		ukfs_modload_dir(const char *);
145ssize_t		ukfs_vfstypes(char *, size_t);
146
147/* Utilities */
148int		ukfs_util_builddirs(struct ukfs *, const char *, mode_t);
149
150__END_DECLS
151
152#endif /* _RUMP_UKFS_H_ */
153