| .. | .. | 
|---|
| 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  */ | 
|---|