From 41ec030db113535f3843bf4922e28b5040328561 Mon Sep 17 00:00:00 2001 From: Ajaykumar Rajappa Date: Mon, 1 Dec 2025 10:17:04 +0100 Subject: [PATCH] ziomon: Update man page to document device symlink support Enhance the ziomon man page to document support for persistent SCSI device symlinks under /dev/disk/ subdirectories (by-id, by-path, by-uuid, etc.). The DESCRIPTION section now clarifies that multipath devices and/or device symlinks resolve to their underlying regular block devices for monitoring. Updated EXAMPLES to include a scenario demonstrating usage with a device symlink alongside regular and multipath devices. Signed-off-by: Ajaykumar Rajappa Reviewed-by: M Nikhil Signed-off-by: Steffen Eiden --- ziomon/ziomon.8 | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/ziomon/ziomon.8 b/ziomon/ziomon.8 index 157bd5db..e65a9c3c 100644 --- a/ziomon/ziomon.8 +++ b/ziomon/ziomon.8 @@ -14,9 +14,10 @@ ziomon \- Collect data for performance analysis of fcp adapters. .SH DESCRIPTION .B ziomon starts and controls various utilities to collect data for performance analysis -for a specified duration. Note that it is possible to specify multipath -devices also. If multipath devices are specified, the respective -regular devices used by the multipath devices will be monitored. +for a specified duration. It is possible to specify multipath devices and persistent +device symlinks from /dev/disk/... subdirectories (such as by-id, by-path, by-uuid, +by-label, etc.). If multipath devices or device symlinks are specified, the respective +underlying regular block devices will be monitored. .SH OPTIONS .TP @@ -61,13 +62,14 @@ Basename for output files. specifies a device to collect respective data for. .SH EXAMPLES -Collect data for devices /dev/sda, /dev/sdg, /dev/sdp and the multipath device -/dev/mapper/36005076303ffc104000000000000212b for 5 minutes. +Collect data for devices /dev/sda, /dev/sdg, /dev/sdp, the multipath device +/dev/mapper/36005076303ffc104000000000000212b and the device symlink +/dev/disk/by-id/scsi-36005076307ffd72c00000000000054f5 for 5 minutes. Data should be sampled every 20 seconds. The collected data size should not exceed 50 MB. The output files should base their names on 'trace_data': -ziomon -i 20 -d 5 -l 50M -o trace_data /dev/mapper/36005076303ffc104000000000000212b /dev/sda /dev/sdg /dev/sdp +ziomon -i 20 -d 5 -l 50M -o trace_data /dev/sda /dev/sdg /dev/sdp /dev/mapper/36005076303ffc104000000000000212b /dev/disk/by-id/scsi-36005076307ffd72c00000000000054f5 .SH "SEE ALSO" .BR ziomon_mgr (8),