rust: sync: make doctests compilable/testable - kernel

diff options

author	Miguel Ojeda <[email protected]>	2023-07-18 05:27:49 +0000
committer	Shuah Khan <[email protected]>	2023-07-19 15:32:41 +0000
commit	bfa7dff036f0cbb2ccb0385c8b666204d6b8eb3a (patch)
tree	b620935c27815fe54deecfb9a705af5cc1140eac /scripts/rustdoc_test_builder.rs
parent	rust: str: make doctests compilable/testable (diff)
download	kernel-bfa7dff036f0cbb2ccb0385c8b666204d6b8eb3a.tar.gz kernel-bfa7dff036f0cbb2ccb0385c8b666204d6b8eb3a.zip

rust: sync: make doctests compilable/testable

Rust documentation tests are going to be build/run-tested with the KUnit integration added in a future patch, thus update them to make them compilable/testable so that we may start enforcing it. Reviewed-by: Martin Rodriguez Reboredo <[email protected]> Reviewed-by: Björn Roy Baron <[email protected]> Reviewed-by: Alice Ryhl <[email protected]> Reviewed-by: David Gow <[email protected]> Signed-off-by: Miguel Ojeda <[email protected]> Signed-off-by: Shuah Khan <[email protected]>

Diffstat (limited to 'scripts/rustdoc_test_builder.rs')

0 files changed, 0 insertions, 0 deletions

/* * linux/drivers/message/fusion/mptioctl.h * Fusion MPT misc device (ioctl) driver. * For use with PCI chip/adapter(s): * LSIFC9xx/LSI409xx Fibre Channel * running LSI Fusion MPT (Message Passing Technology) firmware. * * Copyright (c) 1999-2008 LSI Corporation * (mailto:DL-MPTFusionLinux@lsi.com) * */ /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/ /* This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. NO WARRANTY THE PROGRAM IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is solely responsible for determining the appropriateness of using and distributing the Program and assumes all risks associated with its exercise of rights under this Agreement, including but not limited to the risks and costs of program errors, damage to or loss of data, programs or equipment, and unavailability or interruption of operations. DISCLAIMER OF LIABILITY NEITHER RECIPIENT NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */ #ifndef MPTCTL_H_INCLUDED #define MPTCTL_H_INCLUDED /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/ /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/ /* * */ #define MPT_MISCDEV_BASENAME "mptctl" #define MPT_MISCDEV_PATHNAME "/dev/" MPT_MISCDEV_BASENAME #define MPT_PRODUCT_LENGTH 12 /* * Generic MPT Control IOCTLs and structures */ #define MPT_MAGIC_NUMBER 'm' #define MPTRWPERF _IOWR(MPT_MAGIC_NUMBER,0,struct mpt_raw_r_w) #define MPTFWDOWNLOAD _IOWR(MPT_MAGIC_NUMBER,15,struct mpt_fw_xfer) #define MPTCOMMAND _IOWR(MPT_MAGIC_NUMBER,20,struct mpt_ioctl_command) #if defined(__KERNEL__) && defined(CONFIG_COMPAT) #define MPTFWDOWNLOAD32 _IOWR(MPT_MAGIC_NUMBER,15,struct mpt_fw_xfer32) #define MPTCOMMAND32 _IOWR(MPT_MAGIC_NUMBER,20,struct mpt_ioctl_command32) #endif #define MPTIOCINFO _IOWR(MPT_MAGIC_NUMBER,17,struct mpt_ioctl_iocinfo) #define MPTIOCINFO1 _IOWR(MPT_MAGIC_NUMBER,17,struct mpt_ioctl_iocinfo_rev0) #define MPTIOCINFO2 _IOWR(MPT_MAGIC_NUMBER,17,struct mpt_ioctl_iocinfo_rev1) #define MPTTARGETINFO _IOWR(MPT_MAGIC_NUMBER,18,struct mpt_ioctl_targetinfo) #define MPTTEST _IOWR(MPT_MAGIC_NUMBER,19,struct mpt_ioctl_test) #define MPTEVENTQUERY _IOWR(MPT_MAGIC_NUMBER,21,struct mpt_ioctl_eventquery) #define MPTEVENTENABLE _IOWR(MPT_MAGIC_NUMBER,22,struct mpt_ioctl_eventenable) #define MPTEVENTREPORT _IOWR(MPT_MAGIC_NUMBER,23,struct mpt_ioctl_eventreport) #define MPTHARDRESET _IOWR(MPT_MAGIC_NUMBER,24,struct mpt_ioctl_diag_reset) #define MPTFWREPLACE _IOWR(MPT_MAGIC_NUMBER,25,struct mpt_ioctl_replace_fw) /* * SPARC PLATFORM REMARKS: * IOCTL data structures that contain pointers * will have different sizes in the driver and applications * (as the app. will not use 8-byte pointers). * Apps should use MPTFWDOWNLOAD and MPTCOMMAND. * The driver will convert data from * mpt_fw_xfer32 (mpt_ioctl_command32) to mpt_fw_xfer (mpt_ioctl_command) * internally. * * If data structures change size, must handle as in IOCGETINFO. */ struct mpt_fw_xfer { unsigned int iocnum; /* IOC unit number */ unsigned int fwlen; void __user *bufp; /* Pointer to firmware buffer */ }; #if defined(__KERNEL__) && defined(CONFIG_COMPAT) struct mpt_fw_xfer32 { unsigned int iocnum; unsigned int fwlen; u32 bufp; }; #endif /*}*/ /* * IOCTL header structure. * iocnum - must be defined. * port - must be defined for all IOCTL commands other than MPTIOCINFO * maxDataSize - ignored on MPTCOMMAND commands * - ignored on MPTFWREPLACE commands * - on query commands, reports the maximum number of bytes to be returned * to the host driver (count includes the header). * That is, set to sizeof(struct mpt_ioctl_iocinfo) for fixed sized commands. * Set to sizeof(struct mpt_ioctl_targetinfo) + datasize for variable * sized commands. (MPTTARGETINFO, MPTEVENTREPORT) */ typedef struct _mpt_ioctl_header { unsigned int iocnum; /* IOC unit number */ unsigned int port; /* IOC port number */ int maxDataSize; /* Maximum Num. bytes to transfer on read */ } mpt_ioctl_header; /* * Issue a diagnostic reset */ struct mpt_ioctl_diag_reset { mpt_ioctl_header hdr; }; /* * PCI bus/device/function information structure. */ struct mpt_ioctl_pci_info { union { struct { unsigned int deviceNumber : 5; unsigned int functionNumber : 3; unsigned int busNumber : 24; } bits; unsigned int asUlong; } u; }; struct mpt_ioctl_pci_info2 { union { struct { unsigned int deviceNumber : 5; unsigned int functionNumber : 3; unsigned int busNumber : 24; } bits; unsigned int asUlong; } u; int segmentID; }; /* * Adapter Information Page * Read only. * Data starts at offset 0xC */ #define MPT_IOCTL_INTERFACE_SCSI (0x00) #define MPT_IOCTL_INTERFACE_FC (0x01) #define MPT_IOCTL_INTERFACE_FC_IP (0x02) #define MPT_IOCTL_INTERFACE_SAS (0x03) #define MPT_IOCTL_VERSION_LENGTH (32) struct mpt_ioctl_iocinfo { mpt_ioctl_header hdr; int adapterType; /* SCSI or FCP */ int port; /* port number */ int pciId; /* PCI Id. */ int hwRev; /* hardware revision */ int subSystemDevice; /* PCI subsystem Device ID */ int subSystemVendor; /* PCI subsystem Vendor ID */ int numDevices; /* number of devices */ int FWVersion; /* FW Version (integer) */ int BIOSVersion; /* BIOS Version (integer) */ char driverVersion[MPT_IOCTL_VERSION_LENGTH]; /* Driver Version (string) */ char busChangeEvent; char hostId; char rsvd[2]; struct mpt_ioctl_pci_info2 pciInfo; /* Added Rev 2 */ }; struct mpt_ioctl_iocinfo_rev1 { mpt_ioctl_header hdr; int adapterType; /* SCSI or FCP */ int port; /* port number */ int pciId; /* PCI Id. */ int hwRev; /* hardware revision */ int subSystemDevice; /* PCI subsystem Device ID */ int subSystemVendor; /* PCI subsystem Vendor ID */ int numDevices; /* number of devices */ int FWVersion; /* FW Version (integer) */ int BIOSVersion; /* BIOS Version (integer) */ char driverVersion[MPT_IOCTL_VERSION_LENGTH]; /* Driver Version (string) */ char busChangeEvent; char hostId; char rsvd[2]; struct mpt_ioctl_pci_info pciInfo; /* Added Rev 1 */ }; /* Original structure, must always accept these * IOCTLs. 4 byte pads can occur based on arch with * above structure. Wish to re-align, but cannot. */ struct mpt_ioctl_iocinfo_rev0 { mpt_ioctl_header hdr; int adapterType; /* SCSI or FCP */ int port; /* port number */ int pciId; /* PCI Id. */ int hwRev; /* hardware revision */ int subSystemDevice; /* PCI subsystem Device ID */ int subSystemVendor; /* PCI subsystem Vendor ID */ int numDevices; /* number of devices */ int FWVersion; /* FW Version (integer) */ int BIOSVersion; /* BIOS Version (integer) */ char driverVersion[MPT_IOCTL_VERSION_LENGTH]; /* Driver Version (string) */ char busChangeEvent; char hostId; char rsvd[2]; }; /* * Device Information Page * Report the number of, and ids of, all targets * on this IOC. The ids array is a packed structure * of the known targetInfo. * bits 31-24: reserved * 23-16: LUN * 15- 8: Bus Number * 7- 0: Target ID */ struct mpt_ioctl_targetinfo { mpt_ioctl_header hdr; int numDevices; /* Num targets on this ioc */ int targetInfo[1]; }; /* * Event reporting IOCTL's. These IOCTL's will * use the following defines: */ struct mpt_ioctl_eventquery { mpt_ioctl_header hdr;


context:
space:
mode: