2 * Copyright (c) 2004 The DragonFly Project. All rights reserved.
4 * This code is derived from software contributed to The DragonFly Project
5 * by Matthew Dillon <dillon@backplane.com>
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
11 * 1. Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in
15 * the documentation and/or other materials provided with the
17 * 3. Neither the name of The DragonFly Project nor the names of its
18 * contributors may be used to endorse or promote products derived
19 * from this software without specific, prior written permission.
21 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
24 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
25 * COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
26 * INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
27 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
28 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
29 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
30 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
31 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
35 #ifndef _SYS_MOUNTCTL_H_
36 #define _SYS_MOUNTCTL_H_
39 #include <sys/types.h>
45 #include <sys/queue.h>
48 #if defined(_KERNEL) || defined(_KERNEL_STRUCTURES)
49 #ifndef _SYS_THREAD_H_
50 #include <sys/thread.h>
58 #define JIDMAX 32 /* id string buf[] size (incls \0) */
60 #define MOUNTCTL_INSTALL_VFS_JOURNAL 1
61 #define MOUNTCTL_REMOVE_VFS_JOURNAL 2
62 #define MOUNTCTL_RESYNC_VFS_JOURNAL 3
63 #define MOUNTCTL_STATUS_VFS_JOURNAL 4
64 #define MOUNTCTL_RESTART_VFS_JOURNAL 5
66 #define MOUNTCTL_INSTALL_BLK_JOURNAL 8
67 #define MOUNTCTL_REMOVE_BLK_JOURNAL 9
68 #define MOUNTCTL_RESYNC_BLK_JOURNAL 10
69 #define MOUNTCTL_STATUS_BLK_JOURNAL 11
71 #define MOUNTCTL_SET_EXPORT 16 /* sys/mount.h:export_args */
72 #define MOUNTCTL_STATVFS 17 /* get extended stats */
73 #define MOUNTCTL_MOUNTFLAGS 18 /* extract mountflags */
76 * Data structures for the journaling API
79 struct mountctl_install_journal {
81 int flags; /* journaling flags */
83 int64_t membufsize; /* backing store */
84 int64_t swapbufsize; /* backing store */
85 int64_t transid; /* starting with specified transaction id */
87 int stallwarn; /* stall warning (seconds) */
88 int stallerror; /* stall error (seconds) */
93 #define MC_JOURNAL_UNUSED0001 0x00000001
94 #define MC_JOURNAL_STOP_REQ 0x00000002 /* stop request pend */
95 #define MC_JOURNAL_STOP_IMM 0x00000004 /* STOP+trash fifo */
96 #define MC_JOURNAL_WACTIVE 0x00000008 /* wthread running */
97 #define MC_JOURNAL_RACTIVE 0x00000010 /* rthread running */
98 #define MC_JOURNAL_WWAIT 0x00000040 /* write stall */
99 #define MC_JOURNAL_WANT_AUDIT 0x00010000 /* audit trail */
100 #define MC_JOURNAL_WANT_REVERSABLE 0x00020000 /* reversable stream */
101 #define MC_JOURNAL_WANT_FULLDUPLEX 0x00040000 /* has ack stream */
103 struct mountctl_restart_journal {
109 struct mountctl_remove_journal {
114 #define MC_JOURNAL_REMOVE_TRASH 0x00000001 /* data -> trash */
115 #define MC_JOURNAL_REMOVE_ASSYNC 0x00000002 /* asynchronous op */
117 struct mountctl_status_journal {
122 #define MC_JOURNAL_INDEX_ALL -2
123 #define MC_JOURNAL_INDEX_ID -1
125 struct mountctl_journal_ret_status {
132 int64_t membufunacked;
135 int64_t swapbufunacked;
136 int64_t transidstart;
137 int64_t transidcurrent;
138 int64_t transidunacked;
139 int64_t transidacked;
144 struct timeval lastack;
147 #define MC_JOURNAL_STATUS_MORETOCOME 0x00000001
149 #if defined(_KERNEL) || defined(_KERNEL_STRUCTURES)
152 * Support structures for the generic journaling structure
154 struct journal_memfifo {
155 int size; /* size (power of two) */
156 int mask; /* index mask (size - 1) */
157 int rindex; /* stream reader index (track fd writes) */
158 int xindex; /* last acked / reader restart */
159 int windex; /* stream writer index */
160 char *membase; /* memory buffer representing the FIFO */
164 * Generic journaling structure attached to a mount point.
167 TAILQ_ENTRY(journal) jentry;
170 int flags; /* journaling flags */
174 struct journal_memfifo fifo;
175 struct thread wthread;
176 struct thread rthread;
181 * The jrecord structure is used to build a journaling transaction. Since
182 * a single journaling transaction might encompass very large buffers it
183 * is possible for multiple transactions to be written out to the FIFO
184 * in parallel and in peacemeal.
191 struct journal_rawrecbeg *rawp;
192 struct journal_subrecord *parent;
193 struct journal_subrecord *last;
201 * These fields are not used by the jrecord routines. They may
202 * be used by higher level routines to manage multiple jrecords.
203 * See the jreclist_*() functions.
205 TAILQ_ENTRY(jrecord) user_entry;
209 struct jrecord_list {
210 TAILQ_HEAD(, jrecord) list;
214 #endif /* kernel or kernel structures */
226 void journal_create_threads(struct journal *jo);
227 void journal_destroy_threads(struct journal *jo, int flags);
230 * Primary journal record support procedures
232 void jrecord_init(struct journal *jo,
233 struct jrecord *jrec, int16_t streamid);
234 struct journal_subrecord *jrecord_push(
235 struct jrecord *jrec, int16_t rectype);
236 void jrecord_pop(struct jrecord *jrec, struct journal_subrecord *parent);
237 void jrecord_leaf(struct jrecord *jrec,
238 int16_t rectype, void *ptr, int bytes);
239 void jrecord_leaf_uio(struct jrecord *jrec,
240 int16_t rectype, struct uio *uio);
241 void jrecord_leaf_xio(struct jrecord *jrec,
242 int16_t rectype, struct xio *xio);
243 struct journal_subrecord *jrecord_write(struct jrecord *jrec,
244 int16_t rectype, int bytes);
245 void jrecord_done(struct jrecord *jrec, int abortit);
248 * Rollup journal record support procedures
250 void jrecord_write_path(struct jrecord *jrec,
251 int16_t rectype, struct namecache *ncp);
252 void jrecord_write_vattr(struct jrecord *jrec, struct vattr *vat);
253 void jrecord_write_cred(struct jrecord *jrec, struct thread *td,
255 void jrecord_write_vnode_ref(struct jrecord *jrec, struct vnode *vp);
256 void jrecord_write_vnode_link(struct jrecord *jrec, struct vnode *vp,
257 struct namecache *notncp);
258 void jrecord_write_pagelist(struct jrecord *jrec, int16_t rectype,
259 struct vm_page **pglist, int *rtvals, int pgcount,
261 void jrecord_write_uio(struct jrecord *jrec, int16_t rectype, struct uio *uio);
262 void jrecord_file_data(struct jrecord *jrec, struct vnode *vp,
263 off_t off, off_t bytes);
265 #ifdef MALLOC_DECLARE
266 MALLOC_DECLARE(M_JOURNAL);
267 MALLOC_DECLARE(M_JFIFO);
272 #include <sys/cdefs.h>
275 int mountctl (const char *path, int op, int fd, void *ctl, int ctllen,
276 void *buf, int buflen);