VIRTUTECH CONFIDENTIAL    Previous - Up - Next

fc-disk

Provided by

fc-disk

Class Hierarchy

conf-object → log-object → fc-disk

Interfaces Implemented

log_object, event_poster

Description

Simple model of a Fibre Channel SCSI disk for use with the ISP2200 controller. This device and the controller do not actually use the FC protocol since it is hidden by the controller from the host.

Attributes

Attributes inherited from class conf-object

attributes, classname, component, iface, name, object_id, queue

Attributes inherited from class log-object

access_count, log_buffer, log_buffer_last, log_buffer_size, log_group_mask, log_groups, log_level, log_type_mask

Attribute List

active_queue_id

Optional attribute; read/write access; type: unknown type.

Index in command queue for next command to issue.

command_queue

Optional attribute; read/write access; type: unknown type.

List of commands that are queued for the disk.

data_buffer

Optional attribute; read/write access; type: unknown type.

Buffer with data to transfer.

data_len

Optional attribute; read/write access; type: unknown type.

The length of data to transfer.

fc_controller

Required attribute; read/write access; type: unknown type.

Name of the Fibre Channel controller that this disk is connected to.

free_queue_id

Optional attribute; read/write access; type: unknown type.

Index in command queue for next free slot.

geometry

Required attribute; read/write access; type: unknown type.

The geometry of the disk. ()

image

Required attribute; read/write access; type: unknown type.

Name of the image object holding the actual data of the disk. This object must implement the 'image' interface.

last_command

Pseudo attribute; read-only access; type: Integer.

The last SCSI command sent to the disk

loop_id

Required attribute; read/write access; type: unknown type.

Loop ID on the FC-AL.

mode_pages

Optional attribute; read/write access; type: unknown type.

Mode pages for the disk.

model

Optional attribute; read/write access; type: unknown type.

Model name of the disk.

node_name

Required attribute; read/write access; type: unknown type.

Unique name of the node, as 48 bit IEEE address

ns_per_transfer

Optional attribute; read/write access; type: unknown type.

The constant delay, in nanoseconds, for a disk transfer. This delay will be added to the size-dependent delay set by the 'ns_per_unit' attribute. Note that this is not the same as average seek time for random accesses. (This attribute will be replaced by a more detailed timing model in the future.)

ns_per_unit

Optional attribute; read/write access; type: unknown type.

The number of nanoseconds it takes to transfer data of the size set in the 'timing_unit_size' attribute. This delay will be added to the constant delay set in the 'ns_per_transfer' attribute. (This attribute will be replaced by a more detailed timing model in the future.)

port_name

Required attribute; read/write access; type: unknown type.

Unique name of the port, as 48 bit IEEE address

queue_length

Optional attribute; read/write access; type: unknown type.

Length of SCSI command queue (not implemented).

revision

Optional attribute; read/write access; type: unknown type.

Revision string of the disk.

scsi_commands

Pseudo attribute; read-only access; ; integer indexed; indexed type: String.

Pseudo attribute returning the SCSI command name (as a string) given an integer index representing the command.

sector_data

Pseudo attribute; read/write access; ; integer indexed; indexed type: Data.

Can be used to access a sector (512 bytes) on the disk.

sectors_read

Session attribute; read-only access; type: Integer.

Number of sectors read in the current simulation session.

sectors_written

Session attribute; read-only access; type: Integer.

Number of sectors written in the current simulation session.

sense_key

Optional attribute; read/write access; type: unknown type.

Current Sense Key code.

timing_unit_size

Optional attribute; read/write access; type: unknown type.

The amount of data (in bytes) that makes up a 'unit'. A unit is used to calculate disk delays together with the 'ns_per_unit' attribute. (This attribute will be replaced by a more detailed timing model in the future.)

transfer

Optional attribute; read/write access; type: unknown type.

List of active transfer buffers for data message and status.

vendor

Optional attribute; read/write access; type: unknown type.

Vendor name of the disk.

vendor_specific_id

Optional attribute; read/write access; type: unknown type.

Vendor Specific string for the disk - often used as serial id.

vpd_pages

Optional attribute; read/write access; type: unknown type.

VPD pages for the disk.

Command List

Commands defined by interface log_object

log, log-group, log-level, log-size, log-type

Commands

add-sun-partition	add partition from a file
create-sun-vtoc-header	write a new VTOC to a Sun disk
create-sun-vtoc-partition	write partition data in the VTOC on a Sun disk
delete-sun-vtoc-partition	delete partition data from the VTOC on a Sun disk
dump-sun-partition	write partition as a file
info	information about current state of the fibre-channel disk
print-sun-vtoc	print the VTOC for a Sun disk

Command Descriptions

<fc-disk>.add-sun-partition

Synopsis

<fc-disk>.add-sun-partition number file

Description

Adds an image or diff as a sun partition to the current disk.

See Also

<fc-disk>.dump-sun-partition

<fc-disk>.create-sun-vtoc-header

Synopsis

<fc-disk>.create-sun-vtoc-header [C] [H] [S] [-quiet]

Description

Create and write a new VTOC to a Sun disk. The geometry information written is taken from the configuration attribute 'geometry' of the disk, unless specified with the C, H and S parameters. A new empty partition table is also created, with only the standard 'backup' partition as number 2. -quiet makes the command silent in case of success.

See Also

<fc-disk>.print-sun-vtoc, <fc-disk>.create-sun-vtoc-partition, <fc-disk>.delete-sun-vtoc-partition

<fc-disk>.create-sun-vtoc-partition

Synopsis

<fc-disk>.create-sun-vtoc-partition number "tag" "flag" start-block num-blocks [-quiet]

Description

Write partition information to the VTOC on a Sun disk. This command does not change the format of the disk, and it does not create any file system on the partition. Only the 'Volume Table Of Contents' is modified. No checking is performed to make sure that partitions do not overlap, or that they do not exceed the disk size. -quiet makes the command silent in case of success.

See Also

<fc-disk>.print-sun-vtoc, <fc-disk>.create-sun-vtoc-header, <fc-disk>.delete-sun-vtoc-partition

<fc-disk>.delete-sun-vtoc-partition

Synopsis

<fc-disk>.delete-sun-vtoc-partition number [-quiet]

Description

Delete the information in the VTOC on a Sun disk for the specified partition. No other modification on the disk is performed. -quiet makes the command silent in case of success.

See Also

<fc-disk>.print-sun-vtoc, <fc-disk>.create-sun-vtoc-header, <fc-disk>.create-sun-vtoc-partition

<fc-disk>.dump-sun-partition

Synopsis

<fc-disk>.dump-sun-partition number file

Description

Write all data from a Sun disk partition to the specified file in raw format.

See Also

<fc-disk>.print-sun-vtoc, <fc-disk>.add-sun-partition

<fc-disk>.info

Synopsis

<fc-disk>.info

Description

Print information about the state of the fibre-channel disk.

<fc-disk>.print-sun-vtoc

Synopsis

<fc-disk>.print-sun-vtoc

Description

Print the contents of the VTOC (volume table of contents) for a Sun disk. This is similar to the Solaris 'prtvtoc' command.

See Also

<fc-disk>.create-sun-vtoc-header, <fc-disk>.create-sun-vtoc-partition, <fc-disk>.delete-sun-vtoc-partition

VIRTUTECH CONFIDENTIAL    Previous - Up - Next