Tue Mar 31 15:49:45 2015 UTC ()
Prohibit cross-mount transactions.


(riastradh)
diff -r1.17 -r1.18 src/share/man/man9/fstrans.9

cvs diff -r1.17 -r1.18 src/share/man/man9/fstrans.9 (expand / switch to unified diff)

--- src/share/man/man9/fstrans.9 2015/03/31 15:47:50 1.17
+++ src/share/man/man9/fstrans.9 2015/03/31 15:49:45 1.18
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: fstrans.9,v 1.17 2015/03/31 15:47:50 riastradh Exp $ 1.\" $NetBSD: fstrans.9,v 1.18 2015/03/31 15:49:45 riastradh Exp $
2.\" 2.\"
3.\" Copyright (c) 2007 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2007 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Juergen Hannken-Illjes. 7.\" by Juergen Hannken-Illjes.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -105,26 +105,27 @@ in a @@ -105,26 +105,27 @@ in a
105.Em lazy 105.Em lazy
106transaction, which is allowed while suspending the file system in order 106transaction, which is allowed while suspending the file system in order
107to sync it to its backing store, but blocked while the file system is 107to sync it to its backing store, but blocked while the file system is
108suspended. 108suspended.
109.Pp 109.Pp
110Transactions are per-thread and nestable: if a thread is already in a 110Transactions are per-thread and nestable: if a thread is already in a
111transaction, it can enter another transaction. 111transaction, it can enter another transaction.
112Each 112Each
113.Fn fstrans_start 113.Fn fstrans_start
114must be paired with 114must be paired with
115.Fn fstrans_done . 115.Fn fstrans_done .
116Entering a shared transaction while in a lazy transaction is not 116Entering a shared transaction while in a lazy transaction is not
117allowed and will lead to deadlock. 117allowed and will lead to deadlock.
 118Transactions for multiple distinct mount points may not be nested.
118.Pp 119.Pp
119The file system's 120The file system's
120.Xr VFS_SUSPENDCTL 9 121.Xr VFS_SUSPENDCTL 9
121method can use 122method can use
122.Fn fstrans_setstate 123.Fn fstrans_setstate
123to: 124to:
124.Bl -dash 125.Bl -dash
125.It 126.It
126enter the 127enter the
127.Dv FSTRANS_SUSPENDING 128.Dv FSTRANS_SUSPENDING
128to suspend all normal operations but allow syncing, 129to suspend all normal operations but allow syncing,
129.It 130.It
130enter the 131enter the