avb.h
3.37 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
/*
* Copyright (C) 2016 The Android Open Source Project
*
* Permission is hereby granted, free of charge, to any person
* obtaining a copy of this software and associated documentation
* files (the "Software"), to deal in the Software without
* restriction, including without limitation the rights to use, copy,
* modify, merge, publish, distribute, sublicense, and/or sell copies
* of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be
* included in all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
* BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
* ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
* SOFTWARE.
*/
#ifndef TRUSTY_INTERFACE_AVB_H_
#define TRUSTY_INTERFACE_AVB_H_
#include <trusty/sysdeps.h>
#define AVB_PORT "com.android.trusty.avb"
#define AVB_MAX_BUFFER_LENGTH 2048
enum avb_command {
AVB_REQ_SHIFT = 1,
AVB_RESP_BIT = 1,
READ_ROLLBACK_INDEX = (0 << AVB_REQ_SHIFT),
WRITE_ROLLBACK_INDEX = (1 << AVB_REQ_SHIFT),
AVB_GET_VERSION = (2 << AVB_REQ_SHIFT),
READ_PERMANENT_ATTRIBUTES = (3 << AVB_REQ_SHIFT),
WRITE_PERMANENT_ATTRIBUTES = (4 << AVB_REQ_SHIFT),
READ_LOCK_STATE = (5 << AVB_REQ_SHIFT),
WRITE_LOCK_STATE = (6 << AVB_REQ_SHIFT),
LOCK_BOOT_STATE = (7 << AVB_REQ_SHIFT),
READ_VBMETA_PUBLIC_KEY = (8 << AVB_REQ_SHIFT),
WRITE_VBMETA_PUBLIC_KEY = (9 << AVB_REQ_SHIFT),
WRITE_OEM_UNLOCK_DEVICE_PERMISSION = (10 << AVB_REQ_SHIFT),
READ_OEM_UNLOCK_DEVICE_PERMISSION = (11 << AVB_REQ_SHIFT),
};
/**
* enum avb_error - error codes for AVB protocol
* @AVB_ERROR_NONE: All OK
* @AVB_ERROR_INVALID: Invalid input
* @AVB_ERROR_INTERNAL: Error occurred during an operation in Trusty
*/
enum avb_error {
AVB_ERROR_NONE = 0,
AVB_ERROR_INVALID = 1,
AVB_ERROR_INTERNAL = 2,
};
/**
* avb_message - Serial header for communicating with AVB server
* @cmd: the command. Payload must be a serialized buffer of the
* corresponding request object.
* @result: resulting error code for message, one of avb_error.
* @payload: start of the serialized command specific payload
*/
struct avb_message {
uint32_t cmd;
uint32_t result;
uint8_t payload[0];
};
/**
* avb_rollback_req - request format for [READ|WRITE]_ROLLBACK_INDEX
* @value: value to write to rollback index. Ignored for read.
* @slot: slot number of rollback index to write
*/
struct avb_rollback_req {
uint64_t value;
uint32_t slot;
} TRUSTY_ATTR_PACKED;
/**
* avb_rollback_resp - response format for [READ|WRITE]_ROLLBACK_INDEX.
* @value: value of the requested rollback index.
*/
struct avb_rollback_resp {
uint64_t value;
};
/**
* avb_get_version_resp - response format for AVB_GET_VERSION.
* @version: version of AVB message format
*/
struct avb_get_version_resp {
uint32_t version;
};
#endif /* TRUSTY_INTERFACE_AVB_H_ */