1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
.\" 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
|