libdiskfs: annotate objects managed by libports

Label all port classes and diskfs_port_bucket.  Provide
diskfs_format_debug_info which prints a human-readable description of
a protid object, which notably includes the path and the inode number.

* libdiskfs/diskfs.h (diskfs_format_debug_info): New declaration.
* libdiskfs/init-init.c (diskfs_format_debug_info): New function.
(diskfs_init_diskfs): Add annotations to classes and bucket.

1 files changed, 8 insertions, 0 deletions

diff --git a/libdiskfs/diskfs.h b/libdiskfs/diskfs.h
index 11fb0ad1..c2f97adf 100644
--- a/libdiskfs/diskfs.h
+++ b/libdiskfs/diskfs.h
@@ -591,6 +591,14 @@ error_t (*diskfs_read_symlink_hook)(struct node *np, char *target);
    default function always returns EOPNOTSUPP. */
 error_t diskfs_get_source (struct protid *cred,
                            char *source, size_t source_len);
+
+/* The user may define this function.  The function must provide a
+   human-readable description of PROTID in BUFFER of size SIZE.  The
+   default implementation generates a reasonable amount of
+   information.  */
+error_t diskfs_format_debug_info (const void *protid,
+				  char *buffer, size_t size);
+
 
 /* Libdiskfs contains a node cache.