Return to juke.3 CVS log

Up to [Research Unix] / researchv10no / cmd / worm / oscsi

Annotation of researchv10no/cmd/worm/oscsi/juke.3, revision 1.1.1.1

1.1       root        1: .TH INTERNAL 3
                      2: .CT 2 file_io
                      3: .SH NAME
                      4: jukebox routines
                      5: .tr %"
                      6: .SH SYNOPSIS
                      7: .B "#include %hdr.h%"
                      8: .PP
                      9: .tr %%
                     10: .B "int j_shelf_to_drive(int sh, Side side, int dr, char *err)"
                     11: .PP
                     12: .B "int j_drive_to_shelf(int dr, int sh, Side side, char *err)"
                     13: .PP
                     14: .B "int j_empty_drive(int tlim, char *buf)"
                     15: .PP
                     16: .B "void j_rdshelves(char *buf)"
                     17: .PP
                     18: .B "int j_getstatus(char *buf)"
                     19: .PP
                     20: .B "int j_scsiio(struct scsi_cmd *cmd, int ncmd,"
                     21: .br
                     22: .B "\ \ \ \ \ \ struct scsi_return *ret, int nret, char *err)"
                     23: .PP
                     24: .B "int j_shelfof(char *vol_id)"
                     25: .PP
                     26: .B "int j_volid(int dr, char *err)"
                     27: .PP
                     28: .B "extern char *j_shelf[NSHELF];"
                     29: .PP
                     30: .B "extern void pperror(char *buf, char *mesg);
                     31: .SH DESCRIPTION
                     32: .I J_shelf_to_drive
                     33: places the disk in shelf
                     34: .I sh
                     35: in logical drive
                     36: .IR dr .
                     37: It returns 0 on success;
                     38: otherwise an error message is placed in
                     39: .I err .
                     40: .PP
                     41: .I J_drive_to_shelf
                     42: places the disk
                     43: in logical drive
                     44: .IR dr
                     45: in shelf
                     46: .IR sh .
                     47: If
                     48: .I sh
                     49: is negative,
                     50: the disk is returned to its home shelf.
                     51: It returns 0 on success;
                     52: otherwise an error message is placed in
                     53: .IR err .
                     54: .PP
                     55: .I J_rdshelves
                     56: initializes each element of
                     57: .I j_shelf
                     58: to the volid of the disk on that shelf.
                     59: A zero pointer means there is no disk;
                     60: a name of
                     61: .B UNALLOCATED
                     62: means the disk has not been allocated a name yet.
                     63: It returns 0 on success;
                     64: otherwise an error message is placed in
                     65: .IR err .
                     66: .PP
                     67: .I J_getstatus
                     68: initializes
                     69: .B j_status
                     70: which include the following fields:
                     71: .EX
                     72:        struct Lunstatus lun[NLUN]; /* disk status */
                     73:        uchar shelf[NSHELF];    /* shelf status */
                     74:        uchar iounit;           /* I/O unit status */
                     75:        uchar carrier;          /* carrier status */
                     76:        uchar udrive;           /* upper drive status */
                     77:        uchar ldrive;           /* lower drive status */
                     78: .EE
                     79: A return value of 0 implies success;
                     80: otherwise \-1 is returned and an error message is placed in
                     81: .IR err .
                     82: .PP
                     83: .I J_scsiio
                     84: performs a SCSI transaction.
                     85: It sends the command in
                     86: .I cmd
                     87: and
                     88: .I ncmd
                     89: data bytes and stores the return status in
                     90: .IR ret .
                     91: A return value of 0 implies success;
                     92: otherwise \-1 is returned and an error message is placed in
                     93: .IR err .
                     94: .PP
                     95: .I J_shelfof
                     96: returns the shelf number of the disk labelled
                     97: .IR vol_id .
                     98: If there is no such disk,
                     99: \-1 is returned.
                    100: .PP
                    101: .I J_volid
                    102: returns the volid of the disk on drive
                    103: .I dr
                    104: in
                    105: .IR err .
                    106: A return value of 0 implies success;
                    107: otherwise \-1 is returned and an error message is placed in
                    108: .IR err .
                    109: .PP
                    110: .I Pperror 
                    111: returns an error message that is contained in 
                    112: .IR buf.
                    113: .PP
                    114: .SH "SEE ALSO"
                    115: .SH DIAGNOSTICS

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.