Merge branch 'fix/hda' into topic/hda
[linux-2.6] / include / scsi / scsi_netlink.h
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