| cam_cdbparse.3 (68393) | cam_cdbparse.3 (68716) |
|---|---|
| 1.\" 2.\" Copyright (c) 1998 Kenneth D. Merry. 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright --- 11 unchanged lines hidden (view full) --- 20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" SUCH DAMAGE. 27.\" | 1.\" 2.\" Copyright (c) 1998 Kenneth D. Merry. 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright --- 11 unchanged lines hidden (view full) --- 20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" SUCH DAMAGE. 27.\" |
| 28.\" $FreeBSD: head/lib/libcam/cam_cdbparse.3 68393 2000-11-06 12:41:27Z ru $ | 28.\" $FreeBSD: head/lib/libcam/cam_cdbparse.3 68716 2000-11-14 11:20:58Z ru $ |
| 29.\" 30.\" This man page borrows heavily from the old scsi(3) man page, which had 31.\" the following copyright: 32.\" 33.\" Copyright (c) 1994 HD Associates (hd@world.std.com) 34.\" All rights reserved. 35.\" 36.\" Redistribution and use in source and binary forms, with or without --- 120 unchanged lines hidden (view full) --- 157.Fa "void *gethook" 158.Fc 159.Sh DESCRIPTION 160The CAM buffer/CDB encoding and decoding routines provide a relatively easy 161migration path for userland 162.Tn SCSI 163applications written with the similarly-named 164.Va scsireq_ Ns * | 29.\" 30.\" This man page borrows heavily from the old scsi(3) man page, which had 31.\" the following copyright: 32.\" 33.\" Copyright (c) 1994 HD Associates (hd@world.std.com) 34.\" All rights reserved. 35.\" 36.\" Redistribution and use in source and binary forms, with or without --- 120 unchanged lines hidden (view full) --- 157.Fa "void *gethook" 158.Fc 159.Sh DESCRIPTION 160The CAM buffer/CDB encoding and decoding routines provide a relatively easy 161migration path for userland 162.Tn SCSI 163applications written with the similarly-named 164.Va scsireq_ Ns * |
| 165functions from the old FreeBSD | 165functions from the old 166.Fx |
| 166.Tn SCSI 167layer. 168.Pp 169These functions may be used in new applications, but users may find it 170easier to use the various SCSI CCB building functions included with the 171.Xr cam 3 172library. (e.g. 173.Fn cam_fill_csio , --- 324 unchanged lines hidden (view full) --- 498return the number of assignments performed. 499.Sh SEE ALSO 500.Xr cam 3 , 501.Xr pass 4 , 502.Xr camcontrol 8 503.Sh HISTORY 504.Pp 505The CAM versions of these functions are based upon similar functions | 167.Tn SCSI 168layer. 169.Pp 170These functions may be used in new applications, but users may find it 171easier to use the various SCSI CCB building functions included with the 172.Xr cam 3 173library. (e.g. 174.Fn cam_fill_csio , --- 324 unchanged lines hidden (view full) --- 499return the number of assignments performed. 500.Sh SEE ALSO 501.Xr cam 3 , 502.Xr pass 4 , 503.Xr camcontrol 8 504.Sh HISTORY 505.Pp 506The CAM versions of these functions are based upon similar functions |
| 506implemented for the old FreeBSD | 507implemented for the old 508.Fx |
| 507.Tn SCSI 508layer. The encoding/decoding functions in the old 509.Tn SCSI 510code were written by Peter Dufault. 511.Pp 512Many systems have comparable interfaces to permit a user to construct a 513SCSI command in user space. 514.Pp 515The old 516.Va scsireq 517data structure was almost identical to the SGI /dev/scsi data 518structure. If anyone knows the name of the authors it should 519go here; Peter Dufault first read about it in a 1989 Sun Expert magazine. 520.Pp 521The new CCB data structures are derived from the CAM-2 and CAM-3 522specifications. 523.Pp 524Peter Dufault implemented a clone of SGI's interface in 386bsd that | 509.Tn SCSI 510layer. The encoding/decoding functions in the old 511.Tn SCSI 512code were written by Peter Dufault. 513.Pp 514Many systems have comparable interfaces to permit a user to construct a 515SCSI command in user space. 516.Pp 517The old 518.Va scsireq 519data structure was almost identical to the SGI /dev/scsi data 520structure. If anyone knows the name of the authors it should 521go here; Peter Dufault first read about it in a 1989 Sun Expert magazine. 522.Pp 523The new CCB data structures are derived from the CAM-2 and CAM-3 524specifications. 525.Pp 526Peter Dufault implemented a clone of SGI's interface in 386bsd that |
| 525led to the original FreeBSD | 527led to the original 528.Fx |
| 526.Tn SCSI 527library and the related kernel ioctl. 528If anyone needs that for compatibility contact dufault@hda.com. 529.Sh AUTHORS 530Kenneth Merry implemented the CAM versions of these encoding and decoding 531functions. This current work is based upon earlier work by Peter Dufault. 532.Sh BUGS 533There should probably be a function that encodes both the CDB and the data 534buffer portions of a 535.Tn SCSI 536CCB. I discovered this while implementing the arbitrary command execution 537code in 538.Xr camcontrol 8 , 539but I haven't yet had time to implement such a function. 540.Pp 541Some of the CCB flag descriptions really don't belong here. Rather they 542belong in a generic CCB man page. Since that man page hasn't yet been 543written, the shorter descriptions here will have to suffice. | 529.Tn SCSI 530library and the related kernel ioctl. 531If anyone needs that for compatibility contact dufault@hda.com. 532.Sh AUTHORS 533Kenneth Merry implemented the CAM versions of these encoding and decoding 534functions. This current work is based upon earlier work by Peter Dufault. 535.Sh BUGS 536There should probably be a function that encodes both the CDB and the data 537buffer portions of a 538.Tn SCSI 539CCB. I discovered this while implementing the arbitrary command execution 540code in 541.Xr camcontrol 8 , 542but I haven't yet had time to implement such a function. 543.Pp 544Some of the CCB flag descriptions really don't belong here. Rather they 545belong in a generic CCB man page. Since that man page hasn't yet been 546written, the shorter descriptions here will have to suffice. |