libexport.a: Add documenting comments

[nfs-utils.git] / support / export / client.c

diff --git a/support/export/client.c b/support/export/client.c
index 9a0fc9dabd1f58068a46cfea13d41838e618a830..dc0106767a4d5cc64eaa424cba80f71d461c2589 100644 (file)
--- a/support/export/client.c
+++ b/support/export/client.c
@@ -134,9 +134,13 @@ client_add(nfs_client *clp)
        *cpp = clp;
 }
 
        *cpp = clp;
 }
 

-/* if canonical is set, then we *know* this is already a canonical name
- * so hostname lookup is avoided.
- * This is used when reading /proc/fs/nfs/exports
+/**
+ * client_lookup - look for @hname in our list of cached nfs_clients
+ * @hname: '\0'-terminated ASCII string containing hostname to look for
+ * @canonical: if set, @hname is known to be canonical DNS name
+ *
+ * Returns pointer to a matching or freshly created nfs_client.  NULL
+ * is returned if some problem occurs.

  */
 nfs_client *
 client_lookup(char *hname, int canonical)
  */
 nfs_client *
 client_lookup(char *hname, int canonical)


@@ -215,6 +219,10 @@ client_dup(const nfs_client *clp, const struct addrinfo *ai)
        return new;
 }
 
        return new;
 }
 

+/**
+ * client_release - drop a reference to an nfs_client record
+ *
+ */

 void
 client_release(nfs_client *clp)
 {
 void
 client_release(nfs_client *clp)
 {


@@ -223,6 +231,10 @@ client_release(nfs_client *clp)
        clp->m_count--;
 }
 
        clp->m_count--;
 }
 

+/**
+ * client_freeall - deallocate all nfs_client records
+ *
+ */

 void
 client_freeall(void)
 {
 void
 client_freeall(void)
 {


@@ -558,6 +570,13 @@ client_check(const nfs_client *clp, const struct addrinfo *ai)
        return 0;
 }
 
        return 0;
 }
 

+/**
+ * client_gettype - determine type of nfs_client given an identifier
+ * @ident: '\0'-terminated ASCII string containing a client identifier
+ *
+ * Returns the type of nfs_client record that would be used for
+ * this client.
+ */

 int
 client_gettype(char *ident)
 {
 int
 client_gettype(char *ident)
 {