X-Git-Url: https://git.decadent.org.uk/gitweb/?p=nfs-utils.git;a=blobdiff_plain;f=utils%2Fstatd%2Fstat.c;h=799239f1d956f668c0cf2c79c98175914740b0b4;hp=bcd3550f34d54e1dbcf5feaa24a46c507256195d;hb=dda3455d8b96a7b078bc00c113e1af15ed421d5b;hpb=ca5f2d1e16a6451c1df203bccfd8944ee84c728f

diff --git a/utils/statd/stat.c b/utils/statd/stat.c
index bcd3550..799239f 100644
--- a/utils/statd/stat.c
+++ b/utils/statd/stat.c
@@ -21,6 +21,21 @@
  * status."  My implementation is operative; it returns 'STAT_SUCC'
  * whenever it can resolve the hostname that it's being asked to
  * monitor, and returns 'STAT_FAIL' otherwise.
+ *
+ * sm_inter.x says the 'state' returned should be
+ *   "state number of site sm_name".  It is not clear how to get this.
+ * X/Open says:
+ *   STAT_SUCC
+ *      The NSM will monitor the given host. "sm_stat_res.state" contains
+ *      the state of the NSM.
+ * Which implies that 'state' is the state number of the *local* NSM.
+ * href=http://www.opengroup.org/onlinepubs/9629799/SM_STAT.htm
+ *
+ * We return the *local* state as
+ *   1/ We have easy access to it.
+ *   2/ It might be useful to a remote client who needs it and has no
+ *      other way to get it.
+ *   3/ That's what we always did in the past.
  */
 struct sm_stat_res * 
 sm_stat_1_svc (struct sm_name *argp, struct svc_req *rqstp)