diff options
| -rw-r--r-- | libnetfs/ChangeLog | 5 | ||||
| -rw-r--r-- | libnetfs/netfs.h | 15 |
2 files changed, 14 insertions, 6 deletions
diff --git a/libnetfs/ChangeLog b/libnetfs/ChangeLog index 20260a37..dd71047e 100644 --- a/libnetfs/ChangeLog +++ b/libnetfs/ChangeLog @@ -1,5 +1,10 @@ 2000-12-30 Marcus Brinkmann <marcus@gnu.org> + * netfs.h: Merge Neals words into documentation of netfs_nput, + netfs_nrele, netfs_nref. + +2000-12-30 Marcus Brinkmann <marcus@gnu.org> + * netfs.h: Adjust comment fixes by last change to be more in line with similar comments elsewhere. * make-node.c (netfs_make_node): Return 0 if malloc does. diff --git a/libnetfs/netfs.h b/libnetfs/netfs.h index b7cb9aaf..013ea859 100644 --- a/libnetfs/netfs.h +++ b/libnetfs/netfs.h @@ -354,16 +354,19 @@ struct protid *netfs_make_protid (struct peropen *po, struct iouser *user); struct peropen *netfs_make_peropen (struct node *, int, struct peropen *context); -/* Add a reference to locked node NP. */ +/* Add a reference to node NP, which must be locked by the caller. */ void netfs_nref (struct node *np); -/* Releases a node. Drops a reference to unlocked node NP. If this - was the last reference, drops the node. */ +/* Releases a node. Drops a reference to node NP, which must not be + locked by the caller. If this was the last reference, drops the + node. The node cannot be used again without first obtaining a + reference to it. */ void netfs_nrele (struct node *np); -/* Puts a node back. Drops a reference to the locked node NP (and - releases the lock, too). If this was the last reference, drops the - node. */ +/* Puts a node back. Drops a reference to the node NP, which must be + locked by the caller (this lock will be released by netfs_nput). + If this was the last reference, drops the node. The node cannot be + used again without first obtaining a reference to it. */ void netfs_nput (struct node *np); /* Called internally when no more references to node NP exist. */ |