perfuse_if.h revision 1.16
1/* $NetBSD: perfuse_if.h,v 1.16 2011/09/09 15:45:28 manu Exp $ */ 2 3/*- 4 * Copyright (c) 2010-2011 Emmanuel Dreyfus. All rights reserved. 5 * 6 * Redistribution and use in source and binary forms, with or without 7 * modification, are permitted provided that the following conditions 8 * are met: 9 * 1. Redistributions of source code must retain the above copyright 10 * notice, this list of conditions and the following disclaimer. 11 * 2. Redistributions in binary form must reproduce the above copyright 12 * notice, this list of conditions and the following disclaimer in the 13 * documentation and/or other materials provided with the distribution. 14 * 15 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 16 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 17 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 18 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 19 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 20 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 21 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 22 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 23 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 24 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 25 * POSSIBILITY OF SUCH DAMAGE. 26 */ 27 28#ifndef _PERFUSE_IF_H 29#define _PERFUSE_IF_H 30 31#ifndef _PATH_PERFUSED 32#define _PATH_PERFUSED "/usr/sbin/perfused" 33#endif /* _PATH_PERFUSED */ 34#define _PATH_FUSE "/dev/fuse" 35#define FUSE_COMMFD_ENV "_FUSE_COMMFD" 36#define PERFUSE_MOUNT_MAGIC "noFuseRq" 37#define PERFUSE_UNKNOWN_INO 0xffffffff 38 39/* 40 * Diagnostic flags. This global is used only for DPRINTF/DERR/DWARN 41 */ 42extern int perfuse_diagflags; 43#define PDF_FOREGROUND 0x0001 /* we run in foreground */ 44#define PDF_FUSE 0x0002 /* Display FUSE reqeusts and reply */ 45#define PDF_DUMP 0x0004 /* Dump FUSE frames */ 46#define PDF_PUFFS 0x0008 /* Display PUFFS requets and reply */ 47#define PDF_FH 0x0010 /* File handles */ 48#define PDF_RECLAIM 0x0020 /* Reclaimed files */ 49#define PDF_READDIR 0x0040 /* readdir operations */ 50#define PDF_REQUEUE 0x0080 /* reueued messages */ 51#define PDF_SYNC 0x0100 /* fsync and dirty flags */ 52#define PDF_MISC 0x0200 /* Miscelaneous messages */ 53#define PDF_SYSLOG 0x0400 /* use syslog */ 54#define PDF_FILENAME 0x0800 /* File names */ 55#define PDF_RESIZE 0x1000 /* Resize operations */ 56 57/* 58 * Diagnostic functions 59 */ 60#define DPRINTF(fmt, ...) do { \ 61 if (perfuse_diagflags & PDF_SYSLOG) \ 62 syslog(LOG_INFO, fmt, ## __VA_ARGS__); \ 63 \ 64 if (perfuse_diagflags & PDF_FOREGROUND) \ 65 (void)printf(fmt, ## __VA_ARGS__); \ 66} while (0 /* CONSTCOND */) 67 68#define DERRX(status, fmt, ...) do { \ 69 if (perfuse_diagflags & PDF_SYSLOG) \ 70 syslog(LOG_ERR, fmt, ## __VA_ARGS__); \ 71 \ 72 if (perfuse_diagflags & PDF_FOREGROUND) { \ 73 (void)fprintf(stderr, fmt, ## __VA_ARGS__); \ 74 abort(); \ 75 } else { \ 76 errx(status, fmt, ## __VA_ARGS__); \ 77 } \ 78} while (0 /* CONSTCOND */) 79 80#define DERR(status, fmt, ...) do { \ 81 if (perfuse_diagflags & PDF_SYSLOG) \ 82 syslog(LOG_ERR, fmt ": %m", ## __VA_ARGS__); \ 83 \ 84 if (perfuse_diagflags & PDF_FOREGROUND) { \ 85 char strerrbuf[BUFSIZ]; \ 86 \ 87 (void)strerror_r(errno, strerrbuf, sizeof(strerrbuf)); \ 88 (void)fprintf(stderr, fmt ": %s", ## __VA_ARGS__, \ 89 strerrbuf); \ 90 abort(); \ 91 } else { \ 92 err(status, fmt, ## __VA_ARGS__); \ 93 } \ 94} while (0 /* CONSTCOND */) 95 96#define DWARNX(fmt, ...) do { \ 97 if (perfuse_diagflags & PDF_SYSLOG) \ 98 syslog(LOG_WARNING, fmt, ## __VA_ARGS__); \ 99 \ 100 warnx(fmt, ## __VA_ARGS__); \ 101} while (0 /* CONSTCOND */) 102 103#define DWARN(fmt, ...) do { \ 104 \ 105 if (perfuse_diagflags & PDF_SYSLOG) \ 106 syslog(LOG_WARNING, fmt ": %m", ## __VA_ARGS__); \ 107 \ 108 warn(fmt, ## __VA_ARGS__); \ 109} while (0 /* CONSTCOND */) 110 111/* 112 * frame handling callbacks 113 */ 114#ifndef PEFUSE_MSG_T 115#define PEFUSE_MSG_T struct perfuse_framebuf 116#endif 117typedef PEFUSE_MSG_T perfuse_msg_t; 118 119#define PERFUSE_UNSPEC_REPLY_LEN (size_t)-1 120 121enum perfuse_xchg_pb_reply { wait_reply, no_reply }; 122typedef perfuse_msg_t *(*perfuse_new_msg_fn)(struct puffs_usermount *, 123 puffs_cookie_t, int, size_t, const struct puffs_cred *); 124typedef int (*perfuse_xchg_msg_fn)(struct puffs_usermount *, 125 perfuse_msg_t *, size_t, enum perfuse_xchg_pb_reply); 126typedef void (*perfuse_destroy_msg_fn)(perfuse_msg_t *); 127typedef struct fuse_out_header *(*perfuse_get_outhdr_fn)(perfuse_msg_t *); 128typedef struct fuse_in_header *(*perfuse_get_inhdr_fn)(perfuse_msg_t *); 129typedef char *(*perfuse_get_inpayload_fn)(perfuse_msg_t *); 130typedef char *(*perfuse_get_outpayload_fn)(perfuse_msg_t *); 131typedef void (*perfuse_umount_fn)(struct puffs_usermount *); 132 133struct perfuse_callbacks { 134 perfuse_new_msg_fn pc_new_msg; 135 perfuse_xchg_msg_fn pc_xchg_msg; 136 perfuse_destroy_msg_fn pc_destroy_msg; 137 perfuse_get_inhdr_fn pc_get_inhdr; 138 perfuse_get_inpayload_fn pc_get_inpayload; 139 perfuse_get_outhdr_fn pc_get_outhdr; 140 perfuse_get_outpayload_fn pc_get_outpayload; 141 perfuse_umount_fn pc_umount; 142}; 143 144/* 145 * mount request 146 */ 147struct perfuse_mount_out { 148 uint32_t pmo_len; 149 int32_t pmo_error; 150 uint64_t pmo_unique; 151 char pmo_magic[sizeof(PERFUSE_MOUNT_MAGIC)]; 152 uint32_t pmo_source_len; 153 uint32_t pmo_target_len; 154 uint32_t pmo_filesystemtype_len; 155 uint32_t pmo_mountflags; 156 uint32_t pmo_data_len; 157 uint32_t pmo_sock_len; 158}; 159 160struct perfuse_mount_info { 161 const char *pmi_source; 162 const char *pmi_target; 163 const char *pmi_filesystemtype; 164 int pmi_mountflags; 165 void *pmi_data; 166 uid_t pmi_uid; 167}; 168 169/* 170 * Duplicated from fuse.h to avoid making it public 171 */ 172#ifndef FUSE_BUFSIZE 173#define FUSE_MIN_BUFSIZE 0x21000 174#define FUSE_PREF_BUFSIZE (sysconf(_SC_PAGESIZE) + 0x1000) 175#define FUSE_BUFSIZE MAX(FUSE_PREF_BUFSIZE /* CONSTCOND */, FUSE_MIN_BUFSIZE) 176#endif /* FUSE_BUFSIZE */ 177 178struct fuse_in_header { 179 uint32_t len; 180 uint32_t opcode; 181 uint64_t unique; 182 uint64_t nodeid; 183 uint32_t uid; 184 uint32_t gid; 185 uint32_t pid; 186 uint32_t padding; 187}; 188 189struct fuse_out_header { 190 uint32_t len; 191 int32_t error; 192 uint64_t unique; 193}; 194 195__BEGIN_DECLS 196 197struct puffs_usermount *perfuse_init(struct perfuse_callbacks *, 198 struct perfuse_mount_info *); 199void perfuse_setspecific(struct puffs_usermount *, void *); 200void *perfuse_getspecific(struct puffs_usermount *); 201uint64_t perfuse_next_unique(struct puffs_usermount *); 202uint64_t perfuse_get_ino(struct puffs_usermount *, puffs_cookie_t); 203int perfuse_inloop(struct puffs_usermount *); 204const char *perfuse_opname(int); 205void perfuse_fs_init(struct puffs_usermount *); 206int perfuse_mainloop(struct puffs_usermount *); 207int perfuse_unmount(struct puffs_usermount *); 208 209#endif /* _PERFUSE_IF_H */ 210