summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRavishankar N <ravishankar@redhat.com>2014-05-22 10:25:47 +0530
committerPranith Kumar Karampuri <pkarampu@redhat.com>2014-05-30 10:29:31 -0700
commit3230db8561ddfec2aa26fc106ec65b4a307b6db6 (patch)
tree1cbdc77ee508c9f1490d728e60eb199546feb402
parent7b96fd92de79f367bfa8591becdb30340a4a26e7 (diff)
cluster/afr: Add descriptions to message-ids.
Change-Id: I7ec2821c96d4cbff78b4959d9b07019896cc9a2c BUG: 1075611 Signed-off-by: Ravishankar N <ravishankar@redhat.com> Reviewed-on: http://review.gluster.org/7840 Reviewed-by: Raghavendra G <rgowdapp@redhat.com> Reviewed-by: N Balachandran <nbalacha@redhat.com> Tested-by: Gluster Build System <jenkins@build.gluster.com> Reviewed-by: Pranith Kumar Karampuri <pkarampu@redhat.com> Tested-by: Pranith Kumar Karampuri <pkarampu@redhat.com>
-rw-r--r--xlators/cluster/afr/src/afr-messages.h75
1 files changed, 75 insertions, 0 deletions
diff --git a/xlators/cluster/afr/src/afr-messages.h b/xlators/cluster/afr/src/afr-messages.h
index a076161aa9c..edb2ed00285 100644
--- a/xlators/cluster/afr/src/afr-messages.h
+++ b/xlators/cluster/afr/src/afr-messages.h
@@ -18,6 +18,10 @@
#include "glfs-message-id.h"
+/*! \file afr-messages.h
+ * \brief AFR log-message IDs and their descriptions.
+ */
+
/* NOTE: Rules for message additions
* 1) Each instance of a message is _better_ left with a unique message ID, even
* if the message format is the same. Reasoning is that, if the message
@@ -46,16 +50,87 @@
#define glfs_msg_start_x GLFS_COMP_BASE_AFR, "Invalid: Start of messages"
+/*!
+ * @messageid 108001
+ * @diagnosis Client quorum is not met due to which file modification
+ * operations are disallowed.
+ * @recommendedaction Some brick processes are down/ not visible from the
+ * client. Ensure that the bricks are up/ network traffic is not blocked.
+ */
#define AFR_MSG_QUORUM_FAIL (GLFS_COMP_BASE_AFR + 1)
+
+
+/*!
+ * @messageid 108002
+ * @diagnosis The bricks that were down are now up and quorum is restored.
+ * @recommendedaction Possibly check why the bricks went down to begin with.
+ */
#define AFR_MSG_QUORUM_MET (GLFS_COMP_BASE_AFR + 2)
+
+
+/*!
+ * @messageid 108003
+ * @diagnosis Client quorum-type was set to auto due to which the quorum-count
+ * option is no longer valid.
+ * @recommendedaction None.
+ */
#define AFR_MSG_QUORUM_OVERRIDE (GLFS_COMP_BASE_AFR + 3)
+
+
+/*!
+ * @messageid 108004
+ * @diagnosis Replication sub volume witnessed a connection notification
+ * from a brick which does not belong to it's replica set.
+ * @recommendedaction None. This is a safety check in code.
+ */
#define AFR_MSG_INVALID_CHILD_UP (GLFS_COMP_BASE_AFR + 4)
+
+
+/*!
+ * @messageid 108005
+ * @diagnosis A brick that was down earlier has come back up.
+ * @recommendedaction Possibly check why the brick went down to begin with.
+ */
#define AFR_MSG_SUBVOL_UP (GLFS_COMP_BASE_AFR + 5)
+
+
+/*!
+ * @messageid 108006
+ * @diagnosis All bricks of a replica set are down. Data residing in that
+ * replica cannot be accessed until one of the bricks come back up.
+ * @recommendedaction Ensure that the bricks are up.
+ */
#define AFR_MSG_ALL_SUBVOLS_DOWN (GLFS_COMP_BASE_AFR + 6)
+
+
+/*!
+ * @messageid 108007
+ * @diagnosis Entry unlocks failed on a brick.
+ * @recommendedaction Error number in the log should give the reason why it
+ * failed. Also observe brick logs for more information.
+*/
#define AFR_MSG_ENTRY_UNLOCK_FAIL (GLFS_COMP_BASE_AFR + 7)
+
+
+/*!
+ * @messageid 108008
+ * @diagnosis There is an inconsistency in the file's data/metadata/gfid
+ * amongst the bricks of a replica set.
+ * @recommendedaction Resolve the split brain by clearing the AFR changelog
+ * attributes from the appropriate brick and trigger self-heal.
+ */
#define AFR_MSG_SPLIT_BRAIN (GLFS_COMP_BASE_AFR + 8)
+
+
+/*!
+ * @messageid 108009
+ * @diagnosis open/opendir failed on a brick.
+ * @recommendedaction Error number in the log should give the reason why it
+ * failed. Also observe brick logs for more information.
+ */
#define AFR_MSG_OPEN_FAIL (GLFS_COMP_BASE_AFR + 9)
+
#define glfs_msg_end_x GLFS_MSGID_END, "Invalid: End of messages"
#endif /* !_AFR_MESSAGES_H_ */