Initial revision
authorroland <roland>
Fri, 28 Jan 1994 07:29:32 +0000 (07:29 +0000)
committerroland <roland>
Fri, 28 Jan 1994 07:29:32 +0000 (07:29 +0000)
hurd/hurd/userlink.h [new file with mode: 0644]

diff --git a/hurd/hurd/userlink.h b/hurd/hurd/userlink.h
new file mode 100644 (file)
index 0000000..648a8c1
--- /dev/null
@@ -0,0 +1,73 @@
+/* Support for chains recording users of a resource; `struct hurd_userlink'.
+Copyright (C) 1994 Free Software Foundation, Inc.
+This file is part of the GNU C Library.
+
+The GNU C Library is free software; you can redistribute it and/or
+modify it under the terms of the GNU Library General Public License as
+published by the Free Software Foundation; either version 2 of the
+License, or (at your option) any later version.
+
+The GNU C Library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+Library General Public License for more details.
+
+You should have received a copy of the GNU Library General Public
+License along with the GNU C Library; see the file COPYING.LIB.  If
+not, write to the Free Software Foundation, Inc., 675 Mass Ave,
+Cambridge, MA 02139, USA.  */
+
+#ifndef        _HURD_USERLINK_H
+
+#define        _HURD_USERLINK_H        1
+#include <features.h>
+
+
+/* This structure is simply a doubly-linked list.  Users of a given
+   resource are recorded by their presence in a list associated with that
+   resource.  A user attaches his own link (in local storage) to a shared
+   chain at the time he begins using some resource.  When finished with
+   that resource, the user removes his link from the chain.  If his link is
+   the last (there are no other users of the resource), and his chain has
+   been detached from the shared cell (the resource in the cell has been
+   replaced), then the user deallocates the resource that he used.  */
+
+struct hurd_userlink
+  {
+    struct hurd_userlink *next, **prevp;
+  };
+
+
+/* Attach LINK to the chain of users at *CHAINP.  */
+
+extern inline struct hurd_userlink *
+_hurd_userlink_link (struct hurd_userlink **chainp,
+                         struct hurd_userlink *link)
+{
+  link->next = *chainp;
+  if (link->next)
+    link->next->prevp = &link->next;
+  link->prevp = chainp;
+  return link;
+}
+
+
+/* Detach LINK from its chain.  If the return value is nonzero, the caller
+   should deallocate the resource he started using after attaching LINK to
+   the chain it's on.  If the return value is zero, then someone else is
+   still using the resource.  */
+
+extern inline int
+_hurd_userlink_unlink (struct hurd_userlink *link)
+{
+  int dealloc = ! link->next && ! link->prevp;
+  /* Remove our link from the chain of current users.  */
+  if (link->prevp)
+    *link->prevp = link->next;
+  if (link->next)
+    link->next->prevp = link->prevp;
+  return dealloc;
+}
+
+
+#endif /* hurd/userlink.h */