[efi] Define an interface operation to describe using an EFI device path

Allow arbitrary objects to support describing themselves using an EFI
device path.

Signed-off-by: Michael Brown <mcb30@ipxe.org>

1 files changed, 26 insertions, 0 deletions

diff --git a/src/interface/efi/efi_path.c b/src/interface/efi/efi_path.c
index 1b297567c..fa4306020 100644
--- a/src/interface/efi/efi_path.c
+++ b/src/interface/efi/efi_path.c
@@ -55,3 +55,29 @@ size_t efi_path_len ( EFI_DEVICE_PATH_PROTOCOL *path ) {
 
 	return ( ( ( void * ) end ) - ( ( void * ) path ) );
 }
+
+/**
+ * Describe object as an EFI device path
+ *
+ * @v intf		Interface
+ * @ret path		EFI device path, or NULL
+ *
+ * The caller is responsible for eventually calling free() on the
+ * allocated device path.
+ */
+EFI_DEVICE_PATH_PROTOCOL * efi_describe ( struct interface *intf ) {
+	struct interface *dest;
+	efi_describe_TYPE ( void * ) *op =
+		intf_get_dest_op ( intf, efi_describe, &dest );
+	void *object = intf_object ( dest );
+	EFI_DEVICE_PATH_PROTOCOL *path;
+
+	if ( op ) {
+		path = op ( object );
+	} else {
+		path = NULL;
+	}
+
+	intf_put ( dest );
+	return path;
+}