IBM TS2340 User Guide - Page 165

File Naming Conventions, Rewind on Close Note 2

Page 165 highlights

Solaris Device Driver (IBMtape) File Naming Conventions Table 28 shows the special file naming convention and the associated device attributes recognized by the IBMtape device driver. Table 28. IBM SCSI Tape/Medium Changer Special Files for Solaris Special File Name BSD Compatibility (Note 1) Rewind on Close (Note 2) Compression (Note 3) /dev/rmt/[0-255]smc (Note 4) N/A N/A N/A /dev/rmt/[0-255]stn (Note 5) No No No /dev/rmt/[0-255]stcn (Note 5) No No Yes /dev/rmt/[0-255]st (Note 5) No Yes No /dev/rmt/[0-255]stc (Note 5) No Yes Yes /dev/rmt/[0-255]stbn (Note 5) Yes /dev/rmt/[0-255]stcbn (Note 5) Yes No No No Yes /dev/rmt/[0-255]stb (Note 5) Yes Yes No /dev/rmt/[0-255]stcb (Note 5) Yes Yes Yes Notes: 1. The BSD (b) device special file modifies close behavior for non-rewind devices. If the device is opened for no rewind on close in non-BSD mode, and if the last command before closing the device was a read, then the tape is positioned after the filemark immediately following the last block read. If the device is opened for no rewind on close in BSD mode, and if the last command before closing the device was a read, the tape is left positioned exactly where it was following the last block read. If the device is opened for rewind on close the BSD mode is not relevant. 2. The no rewind on close (n) device special file does not rewind the tape during a close operation. Otherwise, the tape is rewound when the device is closed. If the last operation before closing the device was a write or write filemark, then a sufficient number of filemarks is written so that two filemarks follow the data. For the non-rewind special files, the tapes are positioned between the trailing filemarks before closing. If the device is then reopened and more data is written, it is separated by a single filemark from the previous data. 3. The compression (c) device special file determines whether the tape device uses built-in hardware compression while storing data on the tape. The compression mode of the device can also be set to the desired state programmatically through the STIOC_SET_PARM ioctl, regardless of the default compression mode established by the special file originally used to open the device. 4. The smc special file is created only for IBM tape systems that provide medium changer capability. For IBM tape libraries and autoloaders, the smc special file is the only file created because the IBMtape device driver supports only the medium changer portion and does not support the tape drive portion of these devices. For the IBM 3490E Magnetic Tape System, there is no smc special file created. 5. Only one st special file may be opened at one time. The smc special file may be opened by itself or in conjunction with one of the st type files. The smc special file accepts only medium changer commands. Tape drive commands issued to the medium changer fail, with errno set to 22, invalid argument. Aside from the normal configuration with the medium changer answering as a distinct target/LUN pair, some supported devices can be configured with a nonstandard integrated medium changer reporting at the same target and LUN as the tape drive. In such a case, both st and smc special files accept a limited subset of medium changer commands. If you want to use this nonstandard mode, consult the appropriate hardware reference to determine whether the drive supports such a configuration. Chapter 6. Solaris Tape and Medium Changer Device Driver 147

  • 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
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316
  • 317
  • 318
  • 319
  • 320
  • 321
  • 322
  • 323
  • 324
  • 325
  • 326
  • 327
  • 328
  • 329
  • 330
  • 331
  • 332
  • 333
  • 334
  • 335
  • 336
  • 337
  • 338
  • 339
  • 340
  • 341
  • 342
  • 343
  • 344
  • 345
  • 346
  • 347
  • 348
  • 349
  • 350
  • 351
  • 352
  • 353
  • 354
  • 355
  • 356
  • 357
  • 358
  • 359
  • 360
  • 361
  • 362
  • 363
  • 364
  • 365
  • 366
  • 367
  • 368
  • 369
  • 370
  • 371
  • 372
  • 373
  • 374
  • 375
  • 376
  • 377
  • 378
  • 379
  • 380
  • 381
  • 382
  • 383
  • 384
  • 385
  • 386
  • 387
  • 388
  • 389
  • 390
  • 391
  • 392
  • 393
  • 394
  • 395
  • 396
  • 397
  • 398
  • 399
  • 400
  • 401
  • 402
  • 403
  • 404
  • 405
  • 406
  • 407
  • 408
  • 409
  • 410
  • 411
  • 412
  • 413
  • 414
  • 415
  • 416
  • 417
  • 418
  • 419
  • 420
  • 421
  • 422
  • 423
  • 424
  • 425
  • 426
  • 427
  • 428
  • 429
  • 430
  • 431
  • 432
  • 433
  • 434
  • 435
  • 436
  • 437
  • 438
  • 439
  • 440
  • 441
  • 442
  • 443
  • 444
  • 445
  • 446
  • 447
  • 448
  • 449
  • 450
  • 451
  • 452
  • 453
  • 454
  • 455
  • 456
  • 457

File Naming Conventions
Table 28 shows the special file naming convention and the associated device
attributes recognized by the IBMtape device driver.
Table 28. IBM SCSI Tape/Medium Changer Special Files for Solaris
Special File Name
BSD Compatibility (Note
1)
Rewind on Close (Note 2)
Compression (Note 3)
/dev/rmt/[0–255]smc
(Note 4)
N/A
N/A
N/A
/dev/rmt/[0–255]stn
(Note 5)
No
No
No
/dev/rmt/[0–255]stcn
(Note 5)
No
No
Yes
/dev/rmt/[0–255]st
(Note 5)
No
Yes
No
/dev/rmt/[0–255]stc
(Note 5)
No
Yes
Yes
/dev/rmt/[0–255]stbn
(Note 5)
Yes
No
No
/dev/rmt/[0–255]stcbn
(Note 5)
Yes
No
Yes
/dev/rmt/[0–255]stb
(Note 5)
Yes
Yes
No
/dev/rmt/[0–255]stcb
(Note 5)
Yes
Yes
Yes
Notes:
1.
The
BSD (b)
device special file modifies
close
behavior for non-rewind devices. If the device is opened for
no
rewind on close
in
non-BSD
mode, and if the last command before closing the device was a read, then the tape
is positioned after the filemark immediately following the last block read. If the device is opened for
no rewind
on close
in
BSD
mode, and if the last command before closing the device was a read, the tape is left positioned
exactly where it was following the last block read. If the device is opened for
rewind on close
the
BSD
mode is
not relevant.
2.
The
no rewind on close (n)
device special file does not rewind the tape during a
close
operation. Otherwise, the
tape is rewound when the device is closed. If the last operation before closing the device was a write or write
filemark, then a sufficient number of filemarks is written so that two filemarks follow the data.
For the non-rewind special files, the tapes are positioned between the trailing filemarks before closing. If the
device is then reopened and more data is written, it is separated by a single filemark from the previous data.
3.
The
compression (c)
device special file determines whether the tape device uses built-in hardware compression
while storing data on the tape. The compression mode of the device can also be set to the desired state
programmatically through the STIOC_SET_PARM
ioctl
, regardless of the default compression mode established
by the special file originally used to open the device.
4.
The
smc
special file is created only for IBM tape systems that provide medium changer capability. For IBM tape
libraries and autoloaders, the
smc
special file is the only file created because the IBMtape device driver supports
only the medium changer portion and does not support the tape drive portion of these devices. For the IBM
3490E Magnetic Tape System, there is no
smc
special file created.
5.
Only one
st
special file may be opened at one time. The
smc
special file may be opened by itself or in
conjunction with one of the
st
type files. The
smc
special file accepts only medium changer commands. Tape
drive commands issued to the medium changer fail, with
errno
set to 22, invalid argument.
Aside from the normal configuration with the medium changer answering as a distinct target/LUN pair, some
supported devices can be configured with a nonstandard integrated medium changer reporting at the same
target and LUN as the tape drive. In such a case, both
st
and
smc
special files accept a limited subset of medium
changer commands. If you want to use this nonstandard mode, consult the appropriate hardware reference to
determine whether the drive supports such a configuration.
Solaris Device Driver (IBMtape)
Chapter 6. Solaris Tape and Medium Changer Device Driver
147