sbdadm(1m) - osol9

1sbdadm(1M)              System Administration Commands              sbdadm(1M)
2
3
4

NAME

6       sbdadm - SCSI Block Disk command line interface
7

SYNOPSIS

9       sbdadm create-lu [-s, --size size] filename
10
11
12       sbdadm delete-lu lu_name
13
14
15       sbdadm import-lu lu_name
16
17
18       sbdadm list-lu lu_name
19
20
21       sbdadm modify-lu [-s, --size size] lu_name | filename
22
23

DESCRIPTION

25       The  sbdadm command creates and manages SCSI-block-device-based logical
26       units that are registered with the SCSI Target Mode Framework (STMF).
27

SUB-COMMANDS

29       The sbdadm command supports the subcommands listed below. Note that  if
30       you  enter  a  question  mark as an argument to the command (sbdadm ?),
31       sbdadm responds with a help display.
32
33       create-lu [-s, --size size] filename
34
35           Create a logical unit that can be registered with the STMF. For the
36           -s option, size is an integer followed by one of the following let‐
37           ters, to indicate a unit of size:
38
39           k    kilobyte
40
41
42           m    megabyte
43
44
45           g    gigabyte
46
47
48           t    terabyte
49
50
51           p    petabyte
52
53
54           e    exabyte
55
56           If you do not specify size, the size defaults to the size of  file‐
57           name.
58
59           The size specified can exceed the size of the file or device.
60
61
62       delete-lu lu_name
63
64           Deletes an existing logical unit that was created using sbdadm cre‐
65           ate-lu. This effectively unloads the logical  unit  from  the  STMF
66           framework. Any existing data on the logical unit remains intact.
67
68
69       import-lu lu_name
70
71           Imports  and loads a logical unit into the STMF that was previously
72           created using sbdadm create-lu and was since deleted from the  STMF
73           using  sbdadm delete-lu. On success, the logical unit is again made
74           available to the STMF. filename is the filename used in the  sbdadm
75           create-lu command for this logical unit.
76
77
78       list-lu
79
80           List all logical units that were created using the sbdadm create-lu
81           command.
82
83
84       modify-lu [-s, --size size] lu_name | filename
85
86           Modifies attributes of an logical unit  created  using  the  sbdadm
87           create-lu command. For the -s option, size is an integer value fol‐
88           lowed by a unit specifier. The unit  specifiers  are  as  described
89           above  under create-lu. When this option is specified, the existing
90           size of the logical unit is changed to the new size.
91
92           The size specified can exceed the size of the file or device repre‐
93           sented by lu_name.
94
95

OPERANDS

97       sbdadm use the following operands:
98
99       filename
100
101           Name  of  an existing file or a fully qualified path to a raw block
102           device.
103
104
105       lu_name
106
107           The 32-byte hexadecimal representation of the logical unit.
108
109

EXAMPLES

111       Example 1 Creating a Logical Unit
112
113
114       The following series of commands creates a 10-gigabyte logical unit.
115
116
117         # touch /export/lun/0
118         # sbdadm create-lu -s 10g /export/lun/0
119         # sbdadm create-lu /dev/rdsk/c1t1d0s0
120
121
122
123       Example 2 Listing Logical Units
124
125
126       The following command lists all logical units.
127
128
129         # sbdadm list-lu
130         Found 2 LU(s)
131
132                        GUID                   DATA SIZE    SOURCE
133         --------------------------------  -----------  ------
134         6000ae4000144f21d92c47b0dd650002  10737352704  /export/lun/0
135         6000ae4000144f21d92c47b0de300032  134283264    /dev/rdsk/c1t1d0s0
136
137
138

EXIT STATUS

140       0
141
142           Successful completion.
143
144
145       non-zero
146
147           An error occurred.
148
149

ATTRIBUTES

151       See attributes(5) for descriptions of the following attributes:
152
153
154
155
156       ┌─────────────────────────────┬─────────────────────────────┐
157       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
158       ├─────────────────────────────┼─────────────────────────────┤
159       │Availability                 │SUNWstmfu                    │
160       ├─────────────────────────────┼─────────────────────────────┤
161       │Interface Stability          │Obsolete Committed           │
162       └─────────────────────────────┴─────────────────────────────┘
163