mirror of
https://github.com/ibm-s390-linux/s390-tools.git
synced 2026-08-05 02:14:52 +00:00
b627b8d8e1
This commit is based on the s390-tools-1.39.0 version. Changes on top of s390-tools-1.39.0: - Add MIT license to all source files - Add LICENSE file - Transform REAMDE to README.md (markdown) - Add AUTHORS.md file - Add CONTRIBUTING.md file - Move changelog from README to CHANGELOG.md file Reviewed-by: Stefan Haberland <sth@linux.vnet.ibm.com> Signed-off-by: Michael Holzheu <holzheu@linux.vnet.ibm.com>
107 lines
2.1 KiB
Groff
107 lines
2.1 KiB
Groff
.\" Copyright IBM Corp. 2015, 2017
|
|
.\" s390-tools is free software; you can redistribute it and/or modify
|
|
.\" it under the terms of the MIT license. See LICENSE for details.
|
|
.\"
|
|
.TH LSHMC 8 "Mar 2015" "s390-tools"
|
|
.\" disable hyphenation for words below
|
|
.hw hmcdrv lshmc
|
|
|
|
.\" save horizontal spacing to registers
|
|
.nr default-word-spacing \n[.ss]
|
|
.nr default-sentence-spacing \n[.sss]
|
|
|
|
.\" define a macro for default horizontal spacing
|
|
.de ssd
|
|
.ss \n[default-word-spacing] \n[default-sentence-spacing]
|
|
..
|
|
|
|
.SH NAME
|
|
lshmc \- list
|
|
.SM HMC
|
|
drive
|
|
.SM DVD
|
|
contents
|
|
|
|
.SH SYNOPSIS
|
|
.TP
|
|
\fBlshmc\fP [OPTIONS] [FILE]
|
|
|
|
.SH DESCRIPTION
|
|
List files on a
|
|
.SM DVD
|
|
in the
|
|
.SM DVD
|
|
drive of the Hardware Management Console
|
|
.ss 0
|
|
(
|
|
.SM HMC
|
|
)
|
|
.ssd
|
|
\&.
|
|
By default, the command lists all files in the root directory of the
|
|
.SM DVD\c
|
|
\&.
|
|
Use FILE to list a different set of files. FILE can specify the path, relative
|
|
to the
|
|
.SM DVD
|
|
root directory, for a directory and file and can contain the * and ? wildcard
|
|
characters.
|
|
|
|
.SH OPTIONS
|
|
.TP
|
|
.B "-h, --help"
|
|
Print help text, then exit.
|
|
.TP
|
|
.B "-v, --version"
|
|
Print version information, then exit.
|
|
.TP
|
|
.B "-s, --short"
|
|
Print only regular files (no directories, symbolic links and special files),
|
|
in a short listing format.
|
|
|
|
.SH EXAMPLES
|
|
|
|
To list the files in a
|
|
.SM HMC
|
|
drive
|
|
.SM DVD
|
|
root directory use:
|
|
.PP
|
|
.nf
|
|
.RS
|
|
.B # lshmc
|
|
.RE
|
|
.fi
|
|
.PP
|
|
In case the kernel module \fIhmcdrv\fP was not loaded in advance use:
|
|
.PP
|
|
.nf
|
|
.RS
|
|
.B # modprobe hmcdrv
|
|
.B # lshmc
|
|
.RE
|
|
.fi
|
|
.PP
|
|
To list all HTML files in subdirectory \fIwww\fP use:
|
|
.PP
|
|
.nf
|
|
.RS
|
|
.B # lshmc /www/*.html
|
|
.RE
|
|
.fi
|
|
.PP
|
|
|
|
.SH DIAGNOSTICS
|
|
The \fBlshmc\fP command needs access to device node \fI/dev/\:hmcdrv\fP. This
|
|
node is created automatically when the \fIhmcdrv\fP kernel module is loaded
|
|
(see Linux kernel configuration option
|
|
.SM CONFIG_HMC_DRV\c
|
|
). The user process that runs the \fBlshmc\fP command must have sufficient
|
|
privileges to read from and write to node \fI/dev/\:hmcdrv\fP. Use the commands
|
|
\fBchown(1)\fP, \fBchgrp(1)\fP and/or \fBchmod(1)\fP on node
|
|
\fI/dev/\:hmcdrv\fP to ensure this condition.
|
|
|
|
.SH SEE ALSO
|
|
.B ls(1), chown(1), chgrp(1), chmod(1)
|
|
and Linux on System z: Device Drivers, Features and Commands
|