| .. | .. |
|---|
| 1 | 1 | /* 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. |
|---|
| 3 | 4 | * Intel Management Engine Interface (Intel MEI) Linux driver |
|---|
| 4 | 5 | * 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 | + */ |
|---|
| 68 | 7 | #ifndef _LINUX_MEI_H |
|---|
| 69 | 8 | #define _LINUX_MEI_H |
|---|
| 70 | 9 | |
|---|
| .. | .. |
|---|
| 127 | 66 | */ |
|---|
| 128 | 67 | #define IOCTL_MEI_NOTIFY_GET _IOR('H', 0x03, __u32) |
|---|
| 129 | 68 | |
|---|
| 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 | + |
|---|
| 130 | 118 | #endif /* _LINUX_MEI_H */ |
|---|