document the find_all_servers function
authorRonnie Sahlberg <ronniesahlberg@gmail.com>
Sat, 2 Jul 2011 00:33:19 +0000 (10:33 +1000)
committerRonnie Sahlberg <ronniesahlberg@gmail.com>
Sat, 2 Jul 2011 00:33:19 +0000 (10:33 +1000)
include/libnfs.h

index 81febb23ec34cb4b7182dc8f98a3e18594842002..0676efa787c58e83aba834986be3363919b0e3b2 100644 (file)
@@ -955,10 +955,24 @@ off_t nfs_get_current_offset(struct nfsfh *nfsfh);
 
 
 
+
+
 struct nfs_server_list {
        struct nfs_server_list *next;
        char *addr;
 };
 
+/*
+ * Sync find_local_servers(<server>)
+ * This function will probe all local networks for NFS server. This function will
+ * block for one second while awaiting for all nfs servers to respond.
+ *
+ * Function returns
+ * NULL : something failed
+ *
+ * struct nfs_server_list : a linked list of all discovered servers
+ * 
+ * returned data must be freed by nfs_free_srvr_list(srv);
+ */
 struct nfs_server_list *nfs_find_local_servers(void);
 void free_nfs_srvr_list(struct nfs_server_list *srv);