summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJustus Winter <4winter@informatik.uni-hamburg.de>2014-06-20 13:54:28 +0200
committerJustus Winter <4winter@informatik.uni-hamburg.de>2014-08-31 12:35:10 +0200
commit520ef2ed66d47bb81a55829a88dda81f62dc95e5 (patch)
tree8f1f6722409557f40bd3eef097e28923b12d214a /doc
parentc19a90851170077b99e694262d002a6e22145b49 (diff)
libdiskfs: fix reference counting of peropen objects
Previously, peropen objects were created with a reference count of zero. Therefore, if diskfs_create_protid fails, passing such an object to diskfs_release_peropen would lead to a reference count underflow. * libdiskfs/peropen-make.c (diskfs_peropen_make): Initialize reference count to one. * libdiskfs/protid-make.c (diskfs_start_protid): And consume this reference on success. Update comment. (diskfs_create_protid): Update comment. * libdiskfs/diskfs.h: Update comments. * libdiskfs/io-duplicate.c (diskfs_S_io_duplicate): Adjust reference counting accordingly. * libdiskfs/io-reauthenticate.c (diskfs_S_io_reauthenticate): Likewise. * libdiskfs/io-restrict-auth.c (diskfs_S_io_restrict_auth): Likewise. * doc/hurd.texi (Diskfs Internals): Update accordingly.
Diffstat (limited to 'doc')
-rw-r--r--doc/hurd.texi4
1 files changed, 2 insertions, 2 deletions
diff --git a/doc/hurd.texi b/doc/hurd.texi
index 07ddfb46..8fa6da72 100644
--- a/doc/hurd.texi
+++ b/doc/hurd.texi
@@ -4431,13 +4431,13 @@ provides.
@deftypefun error_t diskfs_create_protid (@w{struct peropen *@var{po}}, @w{struct iouser *@var{user}}, @w{struct protid **@var{cred}})
Create and return a protid for an existing peropen @var{po} in
@var{cred}, referring to user @var{user}. The node @code{@var{po}->np}
-must be locked.
+must be locked. On success, a reference to @var{po} is consumed.
@end deftypefun
@deftypefun error_t diskfs_start_protid (@w{struct peropen *@var{po}}, @w{struct protid **@var{cred}})
Build and return in @var{cred} a protid which has no user
identification, for peropen @var{po}. The node @code{@var{po}->np} must
-be locked.
+be locked. On success, a reference to @var{po} is consumed.
@end deftypefun
@deftypefun void diskfs_finish_protid (@w{struct protid *@var{cred}}, @w{struct iouser *@var{user}})