@@ -1118,7 +1118,8 @@ int nvme_dump_tree(nvme_root_t r);
11181118 * @d: sysfs directory
11191119 * @attr: sysfs attribute name
11201120 *
1121- * Return: String with the contents of @attr
1121+ * Return: String with the contents of @attr or %NULL in case of an empty value
1122+ * or in case of an error (indicated by non-zero errno code).
11221123 */
11231124char * nvme_get_attr (const char * d , const char * attr );
11241125
@@ -1127,7 +1128,8 @@ char *nvme_get_attr(const char *d, const char *attr);
11271128 * @s: nvme_subsystem_t object
11281129 * @attr: sysfs attribute name
11291130 *
1130- * Return: String with the contents of @attr
1131+ * Return: String with the contents of @attr or %NULL in case of an empty value
1132+ * or in case of an error (indicated by non-zero errno code).
11311133 */
11321134char * nvme_get_subsys_attr (nvme_subsystem_t s , const char * attr );
11331135
@@ -1136,7 +1138,8 @@ char *nvme_get_subsys_attr(nvme_subsystem_t s, const char *attr);
11361138 * @c: Controller instance
11371139 * @attr: sysfs attribute name
11381140 *
1139- * Return: String with the contents of @attr
1141+ * Return: String with the contents of @attr or %NULL in case of an empty value
1142+ * or in case of an error (indicated by non-zero errno code).
11401143 */
11411144char * nvme_get_ctrl_attr (nvme_ctrl_t c , const char * attr );
11421145
@@ -1145,7 +1148,8 @@ char *nvme_get_ctrl_attr(nvme_ctrl_t c, const char *attr);
11451148 * @n: nvme_ns_t object
11461149 * @attr: sysfs attribute name
11471150 *
1148- * Return: String with the contents of @attr
1151+ * Return: String with the contents of @attr or %NULL in case of an empty value
1152+ * or in case of an error (indicated by non-zero errno code).
11491153 */
11501154char * nvme_get_ns_attr (nvme_ns_t n , const char * attr );
11511155
@@ -1164,7 +1168,8 @@ nvme_ns_t nvme_subsystem_lookup_namespace(struct nvme_subsystem *s,
11641168 * @p: nvme_path_t object
11651169 * @attr: sysfs attribute name
11661170 *
1167- * Return: String with the contents of @attr
1171+ * Return: String with the contents of @attr or %NULL in case of an empty value
1172+ * or in case of an error (indicated by non-zero errno code).
11681173 */
11691174char * nvme_get_path_attr (nvme_path_t p , const char * attr );
11701175
0 commit comments