1 /* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */ 2 /* 3 * SCSI Transport Netlink Interface 4 * Used for the posting of outbound SCSI transport events 5 * 6 * Copyright (C) 2006 James Smart, Emulex Corporation 7 */ 8 #ifndef SCSI_NETLINK_H 9 #define SCSI_NETLINK_H 10 11 #include <linux/netlink.h> 12 #include <linux/types.h> 13 14 /* 15 * This file intended to be included by both kernel and user space 16 */ 17 18 /* Single Netlink Message type to send all SCSI Transport messages */ 19 #define SCSI_TRANSPORT_MSG NLMSG_MIN_TYPE + 1 20 21 /* SCSI Transport Broadcast Groups */ 22 /* leaving groups 0 and 1 unassigned */ 23 #define SCSI_NL_GRP_FC_EVENTS (1<<2) /* Group 2 */ 24 #define SCSI_NL_GRP_CNT 3 25 26 27 /* SCSI_TRANSPORT_MSG event message header */ 28 struct scsi_nl_hdr { 29 uint8_t version; 30 uint8_t transport; 31 uint16_t magic; 32 uint16_t msgtype; 33 uint16_t msglen; 34 } __attribute__((aligned(sizeof(uint64_t)))); 35 36 /* scsi_nl_hdr->version value */ 37 #define SCSI_NL_VERSION 1 38 39 /* scsi_nl_hdr->magic value */ 40 #define SCSI_NL_MAGIC 0xA1B2 41 42 /* scsi_nl_hdr->transport value */ 43 #define SCSI_NL_TRANSPORT 0 44 #define SCSI_NL_TRANSPORT_FC 1 45 #define SCSI_NL_MAX_TRANSPORTS 2 46 47 /* Transport-based scsi_nl_hdr->msgtype values are defined in each transport */ 48 49 /* 50 * GENERIC SCSI scsi_nl_hdr->msgtype Values 51 */ 52 /* kernel -> user */ 53 #define SCSI_NL_SHOST_VENDOR 0x0001 54 /* user -> kernel */ 55 /* SCSI_NL_SHOST_VENDOR msgtype is kernel->user and user->kernel */ 56 57 58 /* 59 * Message Structures : 60 */ 61 62 /* macro to round up message lengths to 8byte boundary */ 63 #define SCSI_NL_MSGALIGN(len) (((len) + 7) & ~7) 64 65 66 /* 67 * SCSI HOST Vendor Unique messages : 68 * SCSI_NL_SHOST_VENDOR 69 * 70 * Note: The Vendor Unique message payload will begin directly after 71 * this structure, with the length of the payload per vmsg_datalen. 72 * 73 * Note: When specifying vendor_id, be sure to read the Vendor Type and ID 74 * formatting requirements specified below 75 */ 76 struct scsi_nl_host_vendor_msg { 77 struct scsi_nl_hdr snlh; /* must be 1st element ! */ 78 uint64_t vendor_id; 79 uint16_t host_no; 80 uint16_t vmsg_datalen; 81 } __attribute__((aligned(sizeof(uint64_t)))); 82 83 84 /* 85 * Vendor ID: 86 * If transports post vendor-unique events, they must pass a well-known 87 * 32-bit vendor identifier. This identifier consists of 8 bits indicating 88 * the "type" of identifier contained, and 24 bits of id data. 89 * 90 * Identifiers for each type: 91 * PCI : ID data is the 16 bit PCI Registered Vendor ID 92 */ 93 #define SCSI_NL_VID_TYPE_SHIFT 56 94 #define SCSI_NL_VID_TYPE_MASK ((__u64)0xFF << SCSI_NL_VID_TYPE_SHIFT) 95 #define SCSI_NL_VID_TYPE_PCI ((__u64)0x01 << SCSI_NL_VID_TYPE_SHIFT) 96 #define SCSI_NL_VID_ID_MASK (~ SCSI_NL_VID_TYPE_MASK) 97 98 99 #define INIT_SCSI_NL_HDR(hdr, t, mtype, mlen) \ 100 { \ 101 (hdr)->version = SCSI_NL_VERSION; \ 102 (hdr)->transport = t; \ 103 (hdr)->magic = SCSI_NL_MAGIC; \ 104 (hdr)->msgtype = mtype; \ 105 (hdr)->msglen = mlen; \ 106 } 107 108 #endif /* SCSI_NETLINK_H */ 109 110