| sglist.9 (0cef25aeb2d96e3a54c439a1f9b550ceaea4f792) | sglist.9 (eb5a1e8f38a4cf29a77ac42812356460d5e8cf78) |
|---|---|
| 1.\" 2.\" Copyright (c) 2009 Advanced Computing Technologies LLC 3.\" Written by: John H. Baldwin <jhb@FreeBSD.org> 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: --- 177 unchanged lines hidden (view full) --- 186.Nm 187API provides several routines for building a scatter/gather list to describe 188one or more objects. 189Specifically, the 190.Nm sglist_append 191family of routines can be used to append the physical address ranges described 192by an object to the end of a scatter/gather list. 193All of these routines return 0 on success or an error on failure. | 1.\" 2.\" Copyright (c) 2009 Advanced Computing Technologies LLC 3.\" Written by: John H. Baldwin <jhb@FreeBSD.org> 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: --- 177 unchanged lines hidden (view full) --- 186.Nm 187API provides several routines for building a scatter/gather list to describe 188one or more objects. 189Specifically, the 190.Nm sglist_append 191family of routines can be used to append the physical address ranges described 192by an object to the end of a scatter/gather list. 193All of these routines return 0 on success or an error on failure. |
| 194If a request to append an address range to a scatter/gather list fails, 195the scatter/gather list will remain unchanged. |
|
| 194.Pp 195The 196.Nm sglist_append 197function appends the physical address ranges described by a single kernel 198virtual address range to the scatter/gather list 199.Fa sg . 200The kernel virtual address range starts at 201.Fa buf --- 238 unchanged lines hidden (view full) --- 440function returns the following error on failure: 441.Bl -tag -width Er 442.It Bq Er EFBIG 443There are not enough available segments in the scatter/gather list 444.Fa first 445to append the physical address ranges from 446.Fa second . 447.El | 196.Pp 197The 198.Nm sglist_append 199function appends the physical address ranges described by a single kernel 200virtual address range to the scatter/gather list 201.Fa sg . 202The kernel virtual address range starts at 203.Fa buf --- 238 unchanged lines hidden (view full) --- 442function returns the following error on failure: 443.Bl -tag -width Er 444.It Bq Er EFBIG 445There are not enough available segments in the scatter/gather list 446.Fa first 447to append the physical address ranges from 448.Fa second . 449.El |
| 450.Pp |
|
| 448The 449.Nm sglist_slice 450function returns the following errors on failure: 451.Bl -tag -width Er 452.It Bq Er EINVAL 453The 454.Fa original 455scatter/gather list does not describe enough address space to cover the --- 9 unchanged lines hidden (view full) --- 465.Fa mflags 466failed. 467.It Bq Er EFBIG 468There are not enough available segments in the caller-supplied scatter/gather 469list in 470.Fa *slice 471to describe the requested physical address ranges. 472.El | 451The 452.Nm sglist_slice 453function returns the following errors on failure: 454.Bl -tag -width Er 455.It Bq Er EINVAL 456The 457.Fa original 458scatter/gather list does not describe enough address space to cover the --- 9 unchanged lines hidden (view full) --- 468.Fa mflags 469failed. 470.It Bq Er EFBIG 471There are not enough available segments in the caller-supplied scatter/gather 472list in 473.Fa *slice 474to describe the requested physical address ranges. 475.El |
| 476.Pp |
|
| 473The 474.Nm sglist_split 475function returns the following errors on failure: 476.Bl -tag -width Er 477.It Bq Er EDOOFUS 478The 479.Fa original 480scatter/gather list has more than one reference. --- 23 unchanged lines hidden --- | 477The 478.Nm sglist_split 479function returns the following errors on failure: 480.Bl -tag -width Er 481.It Bq Er EDOOFUS 482The 483.Fa original 484scatter/gather list has more than one reference. --- 23 unchanged lines hidden --- |