[PATCH v4] usbip: make remote list honor parsable output
From: Jason Colapietro
Date: Wed Aug 12 2026 - 17:04:04 EST
The -p option only affects local devices and gadgets. Remote lists
still print their human-readable headings and details, so scripts
cannot parse them using the documented option.
Use one file-scope flag for the list command and honor it in the remote
listing path. Emit the same busid and usbid record used for local
devices while continuing to consume every interface record from the
server.
Fixes: e9837bbb3e69 ("staging: usbip: userspace tools v1.0.0")
Closes: https://bugzilla.kernel.org/show_bug.cgi?id=219502
Cc: stable@xxxxxxxxxxxxxxx
Assisted-by: Codex:gpt-5
Signed-off-by: Jason Colapietro <jasoncola1@xxxxxxxxx>
---
v3 -> v4:
- Make parsable file-scope instead of passing it through list helpers.
- Drop the option-ordering change to preserve existing behavior.
v3: https://lore.kernel.org/r/20260812063910.31293-1-jasoncola1@xxxxxxxxx
tools/usb/usbip/src/usbip_list.c | 48 +++++++++++++++++++-------------
1 file changed, 29 insertions(+), 19 deletions(-)
diff --git a/tools/usb/usbip/src/usbip_list.c b/tools/usb/usbip/src/usbip_list.c
index 3d810bcc..482f11d7 100644
--- a/tools/usb/usbip/src/usbip_list.c
+++ b/tools/usb/usbip/src/usbip_list.c
@@ -36,6 +36,8 @@ static const char usbip_list_usage_string[] =
" -l, --local List the local USB devices\n"
" -d, --device List the local USB gadgets bound to usbip-vudc\n";
+static bool parsable;
+
void usbip_list_usage(void)
{
printf("usage: %s", usbip_list_usage_string);
@@ -80,9 +82,11 @@ static int get_exported_devices(char *host, int sockfd)
return 0;
}
- printf("Exportable USB devices\n");
- printf("======================\n");
- printf(" - %s\n", host);
+ if (!parsable) {
+ printf("Exportable USB devices\n");
+ printf("======================\n");
+ printf(" - %s\n", host);
+ }
for (i = 0; i < reply.ndev; i++) {
memset(&udev, 0, sizeof(udev));
@@ -98,9 +102,14 @@ static int get_exported_devices(char *host, int sockfd)
usbip_names_get_class(class_name, sizeof(class_name),
udev.bDeviceClass, udev.bDeviceSubClass,
udev.bDeviceProtocol);
- printf("%11s: %s\n", udev.busid, product_name);
- printf("%11s: %s\n", "", udev.path);
- printf("%11s: %s\n", "", class_name);
+ if (parsable) {
+ printf("busid=%s#usbid=%04x:%04x#\n", udev.busid,
+ udev.idVendor, udev.idProduct);
+ } else {
+ printf("%11s: %s\n", udev.busid, product_name);
+ printf("%11s: %s\n", "", udev.path);
+ printf("%11s: %s\n", "", class_name);
+ }
for (j = 0; j < udev.bNumInterfaces; j++) {
rc = usbip_net_recv(sockfd, &uintf, sizeof(uintf));
@@ -116,10 +125,12 @@ static int get_exported_devices(char *host, int sockfd)
uintf.bInterfaceClass,
uintf.bInterfaceSubClass,
uintf.bInterfaceProtocol);
- printf("%11s: %2d - %s\n", "", j, class_name);
+ if (!parsable)
+ printf("%11s: %2d - %s\n", "", j, class_name);
}
- printf("\n");
+ if (!parsable)
+ printf("\n");
}
return 0;
@@ -150,7 +161,7 @@ static int list_exported_devices(char *host)
}
static void print_device(const char *busid, const char *vendor,
- const char *product, bool parsable)
+ const char *product)
{
if (parsable)
printf("busid=%s#usbid=%.4s:%.4s#", busid, vendor, product);
@@ -158,13 +169,13 @@ static void print_device(const char *busid, const char *vendor,
printf(" - busid %s (%.4s:%.4s)\n", busid, vendor, product);
}
-static void print_product_name(char *product_name, bool parsable)
+static void print_product_name(char *product_name)
{
if (!parsable)
printf(" %s\n", product_name);
}
-static int list_devices(bool parsable)
+static int list_devices(void)
{
struct udev *udev;
struct udev_enumerate *enumerate;
@@ -229,8 +240,8 @@ static int list_devices(bool parsable)
strtol(idProduct, NULL, 16));
/* Print information. */
- print_device(busid, idVendor, idProduct, parsable);
- print_product_name(product_name, parsable);
+ print_device(busid, idVendor, idProduct);
+ print_product_name(product_name);
printf("\n");
@@ -246,7 +257,7 @@ static int list_devices(bool parsable)
return ret;
}
-static int list_gadget_devices(bool parsable)
+static int list_gadget_devices(void)
{
int ret = -1;
struct udev *udev;
@@ -307,8 +318,8 @@ static int list_gadget_devices(bool parsable)
le16toh(idProduct));
/* Print information. */
- print_device(busid, idVendor_buf, idProduct_buf, parsable);
- print_product_name(product_name, parsable);
+ print_device(busid, idVendor_buf, idProduct_buf);
+ print_product_name(product_name);
printf("\n");
@@ -333,7 +344,6 @@ int usbip_list(int argc, char *argv[])
{ NULL, 0, NULL, 0 }
};
- bool parsable = false;
int opt;
int ret = -1;
@@ -354,10 +364,10 @@ int usbip_list(int argc, char *argv[])
ret = list_exported_devices(optarg);
goto out;
case 'l':
- ret = list_devices(parsable);
+ ret = list_devices();
goto out;
case 'd':
- ret = list_gadget_devices(parsable);
+ ret = list_gadget_devices();
goto out;
default:
goto err_out;
--
2.50.1 (Apple Git-155)