hc
2023-12-11 6778948f9de86c3cfaf36725a7c87dcff9ba247f
kernel/include/uapi/linux/mei.h
....@@ -1,70 +1,9 @@
11 /* SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause) */
2
-/******************************************************************************
2
+/*
3
+ * Copyright(c) 2003-2015 Intel Corporation. All rights reserved.
34 * Intel Management Engine Interface (Intel MEI) Linux driver
45 * Intel MEI Interface Header
5
- *
6
- * This file is provided under a dual BSD/GPLv2 license. When using or
7
- * redistributing this file, you may do so under either license.
8
- *
9
- * GPL LICENSE SUMMARY
10
- *
11
- * Copyright(c) 2003 - 2012 Intel Corporation. All rights reserved.
12
- *
13
- * This program is free software; you can redistribute it and/or modify
14
- * it under the terms of version 2 of the GNU General Public License as
15
- * published by the Free Software Foundation.
16
- *
17
- * This program is distributed in the hope that it will be useful, but
18
- * WITHOUT ANY WARRANTY; without even the implied warranty of
19
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20
- * General Public License for more details.
21
- *
22
- * You should have received a copy of the GNU General Public License
23
- * along with this program; if not, write to the Free Software
24
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110,
25
- * USA
26
- *
27
- * The full GNU General Public License is included in this distribution
28
- * in the file called LICENSE.GPL.
29
- *
30
- * Contact Information:
31
- * Intel Corporation.
32
- * linux-mei@linux.intel.com
33
- * http://www.intel.com
34
- *
35
- * BSD LICENSE
36
- *
37
- * Copyright(c) 2003 - 2012 Intel Corporation. All rights reserved.
38
- * All rights reserved.
39
- *
40
- * Redistribution and use in source and binary forms, with or without
41
- * modification, are permitted provided that the following conditions
42
- * are met:
43
- *
44
- * * Redistributions of source code must retain the above copyright
45
- * notice, this list of conditions and the following disclaimer.
46
- * * Redistributions in binary form must reproduce the above copyright
47
- * notice, this list of conditions and the following disclaimer in
48
- * the documentation and/or other materials provided with the
49
- * distribution.
50
- * * Neither the name Intel Corporation nor the names of its
51
- * contributors may be used to endorse or promote products derived
52
- * from this software without specific prior written permission.
53
- *
54
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
55
- * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
56
- * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
57
- * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
58
- * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
59
- * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
60
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
61
- * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
62
- * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
63
- * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
64
- * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
65
- *
66
- *****************************************************************************/
67
-
6
+ */
687 #ifndef _LINUX_MEI_H
698 #define _LINUX_MEI_H
709
....@@ -127,4 +66,53 @@
12766 */
12867 #define IOCTL_MEI_NOTIFY_GET _IOR('H', 0x03, __u32)
12968
69
+/**
70
+ * struct mei_connect_client_vtag - mei client information struct with vtag
71
+ *
72
+ * @in_client_uuid: UUID of client to connect
73
+ * @vtag: virtual tag
74
+ * @reserved: reserved for future use
75
+ */
76
+struct mei_connect_client_vtag {
77
+ uuid_le in_client_uuid;
78
+ __u8 vtag;
79
+ __u8 reserved[3];
80
+};
81
+
82
+/**
83
+ * struct mei_connect_client_data_vtag - IOCTL connect data union
84
+ *
85
+ * @connect: input connect data
86
+ * @out_client_properties: output client data
87
+ */
88
+struct mei_connect_client_data_vtag {
89
+ union {
90
+ struct mei_connect_client_vtag connect;
91
+ struct mei_client out_client_properties;
92
+ };
93
+};
94
+
95
+/**
96
+ * DOC:
97
+ * This IOCTL is used to associate the current file descriptor with a
98
+ * FW Client (given by UUID), and virtual tag (vtag).
99
+ * The IOCTL opens a communication channel between a host client and
100
+ * a FW client on a tagged channel. From this point on, every read
101
+ * and write will communicate with the associated FW client with
102
+ * on the tagged channel.
103
+ * Upone close() the communication is terminated.
104
+ *
105
+ * The IOCTL argument is a struct with a union that contains
106
+ * the input parameter and the output parameter for this IOCTL.
107
+ *
108
+ * The input parameter is UUID of the FW Client, a vtag [0,255]
109
+ * The output parameter is the properties of the FW client
110
+ * (FW protocool version and max message size).
111
+ *
112
+ * Clients that do not support tagged connection
113
+ * will respond with -EOPNOTSUPP.
114
+ */
115
+#define IOCTL_MEI_CONNECT_CLIENT_VTAG \
116
+ _IOWR('H', 0x04, struct mei_connect_client_data_vtag)
117
+
130118 #endif /* _LINUX_MEI_H */