1 /* 2 * SCSI Transport Netlink Interface 3 * Used for the posting of outbound SCSI transport events 4 * 5 * Copyright (C) 2006 James Smart, Emulex Corporation 6 * 7 * This program is free software; you can redistribute it and/or modify 8 * it under the terms of the GNU General Public License as published by 9 * the Free Software Foundation; either version 2 of the License, or 10 * (at your option) any later version. 11 * 12 * This program is distributed in the hope that it will be useful, 13 * but WITHOUT ANY WARRANTY; without even the implied warranty of 14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 15 * GNU General Public License for more details. 16 * 17 * You should have received a copy of the GNU General Public License 18 * along with this program; if not, write to the Free Software 19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 20 * 21 */ 22 #ifndef SCSI_NETLINK_H 23 #define SCSI_NETLINK_H 24 25 #include <linux/netlink.h> 26 27 28 /* 29 * This file intended to be included by both kernel and user space 30 */ 31 32 /* Single Netlink Message type to send all SCSI Transport messages */ 33 #define SCSI_TRANSPORT_MSG NLMSG_MIN_TYPE + 1 34 35 /* SCSI Transport Broadcast Groups */ 36 /* leaving groups 0 and 1 unassigned */ 37 #define SCSI_NL_GRP_FC_EVENTS (1<<2) /* Group 2 */ 38 #define SCSI_NL_GRP_CNT 3 39 40 41 /* SCSI_TRANSPORT_MSG event message header */ 42 struct scsi_nl_hdr { 43 uint8_t version; 44 uint8_t transport; 45 uint16_t magic; 46 uint16_t msgtype; 47 uint16_t msglen; 48 } __attribute__((aligned(sizeof(uint64_t)))); 49 50 /* scsi_nl_hdr->version value */ 51 #define SCSI_NL_VERSION 1 52 53 /* scsi_nl_hdr->magic value */ 54 #define SCSI_NL_MAGIC 0xA1B2 55 56 /* scsi_nl_hdr->transport value */ 57 #define SCSI_NL_TRANSPORT 0 58 #define SCSI_NL_TRANSPORT_FC 1 59 #define SCSI_NL_MAX_TRANSPORTS 2 60 61 /* Transport-based scsi_nl_hdr->msgtype values are defined in each transport */ 62 63 /* 64 * GENERIC SCSI scsi_nl_hdr->msgtype Values 65 */ 66 /* kernel -> user */ 67 #define SCSI_NL_SHOST_VENDOR 0x0001 68 /* user -> kernel */ 69 /* SCSI_NL_SHOST_VENDOR msgtype is kernel->user and user->kernel */ 70 71 72 /* 73 * Message Structures : 74 */ 75 76 /* macro to round up message lengths to 8byte boundary */ 77 #define SCSI_NL_MSGALIGN(len) (((len) + 7) & ~7) 78 79 80 /* 81 * SCSI HOST Vendor Unique messages : 82 * SCSI_NL_SHOST_VENDOR 83 * 84 * Note: The Vendor Unique message payload will begin directly after 85 * this structure, with the length of the payload per vmsg_datalen. 86 * 87 * Note: When specifying vendor_id, be sure to read the Vendor Type and ID 88 * formatting requirements specified below 89 */ 90 struct scsi_nl_host_vendor_msg { 91 struct scsi_nl_hdr snlh; /* must be 1st element ! */ 92 uint64_t vendor_id; 93 uint16_t host_no; 94 uint16_t vmsg_datalen; 95 } __attribute__((aligned(sizeof(uint64_t)))); 96 97 98 /* 99 * Vendor ID: 100 * If transports post vendor-unique events, they must pass a well-known 101 * 32-bit vendor identifier. This identifier consists of 8 bits indicating 102 * the "type" of identifier contained, and 24 bits of id data. 103 * 104 * Identifiers for each type: 105 * PCI : ID data is the 16 bit PCI Registered Vendor ID 106 */ 107 #define SCSI_NL_VID_TYPE_SHIFT 56 108 #define SCSI_NL_VID_TYPE_MASK ((__u64)0xFF << SCSI_NL_VID_TYPE_SHIFT) 109 #define SCSI_NL_VID_TYPE_PCI ((__u64)0x01 << SCSI_NL_VID_TYPE_SHIFT) 110 #define SCSI_NL_VID_ID_MASK (~ SCSI_NL_VID_TYPE_MASK) 111 112 113 #define INIT_SCSI_NL_HDR(hdr, t, mtype, mlen) \ 114 { \ 115 (hdr)->version = SCSI_NL_VERSION; \ 116 (hdr)->transport = t; \ 117 (hdr)->magic = SCSI_NL_MAGIC; \ 118 (hdr)->msgtype = mtype; \ 119 (hdr)->msglen = mlen; \ 120 } 121 122 123 #ifdef __KERNEL__ 124 125 #include <scsi/scsi_host.h> 126 127 /* Exported Kernel Interfaces */ 128 int scsi_nl_add_transport(u8 tport, 129 int (*msg_handler)(struct sk_buff *), 130 void (*event_handler)(struct notifier_block *, unsigned long, void *)); 131 void scsi_nl_remove_transport(u8 tport); 132 133 int scsi_nl_add_driver(u64 vendor_id, struct scsi_host_template *hostt, 134 int (*nlmsg_handler)(struct Scsi_Host *shost, void *payload, 135 u32 len, u32 pid), 136 void (*nlevt_handler)(struct notifier_block *nb, 137 unsigned long event, void *notify_ptr)); 138 void scsi_nl_remove_driver(u64 vendor_id); 139 140 void scsi_nl_send_transport_msg(u32 pid, struct scsi_nl_hdr *hdr); 141 int scsi_nl_send_vendor_msg(u32 pid, unsigned short host_no, u64 vendor_id, 142 char *data_buf, u32 data_len); 143 144 #endif /* __KERNEL__ */ 145 146 #endif /* SCSI_NETLINK_H */ 147 148