You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
70 lines
2.8 KiB
70 lines
2.8 KiB
3 years ago
|
/* BEGIN_LEGAL
|
||
|
|
|
||
|
|
Copyright (c) 2021 Intel Corporation
|
||
|
|
|
||
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
||
|
|
you may not use this file except in compliance with the License.
|
||
|
|
You may obtain a copy of the License at
|
||
|
|
|
||
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
||
|
|
|
||
|
|
Unless required by applicable law or agreed to in writing, software
|
||
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
||
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
|
|
See the License for the specific language governing permissions and
|
||
|
|
limitations under the License.
|
||
|
|
|
||
|
|
END_LEGAL */
|
||
|
|
/// @file xed-decode.h
|
||
|
|
|
||
|
|
|
||
|
|
#ifndef XED_DECODE_H
|
||
|
|
# define XED_DECODE_H
|
||
|
|
|
||
|
|
#include "xed-decoded-inst.h"
|
||
|
|
#include "xed-error-enum.h"
|
||
|
|
#include "xed-chip-features.h"
|
||
|
|
|
||
|
|
/// This is the main interface to the decoder.
|
||
|
|
/// @param xedd the decoded instruction of type #xed_decoded_inst_t . Mode/state sent in via xedd; See the #xed_state_t
|
||
|
|
/// @param itext the pointer to the array of instruction text bytes
|
||
|
|
/// @param bytes the length of the itext input array. 1 to 15 bytes, anything more is ignored.
|
||
|
|
/// @return #xed_error_enum_t indicating success (#XED_ERROR_NONE) or failure. Note failure can be due to not
|
||
|
|
/// enough bytes in the input array.
|
||
|
|
///
|
||
|
|
/// The maximum instruction is 15B and XED will tell you how long the
|
||
|
|
/// actual instruction is via an API function call
|
||
|
|
/// xed_decoded_inst_get_length(). However, it is not always safe or
|
||
|
|
/// advisable for XED to read 15 bytes if the decode location is at the
|
||
|
|
/// boundary of some sort of protection limit. For example, if one is
|
||
|
|
/// decoding near the end of a page and the XED user does not want to cause
|
||
|
|
/// extra page faults, one might send in the number of bytes that would
|
||
|
|
/// stop at the page boundary. In this case, XED might not be able to
|
||
|
|
/// decode the instruction and would return an error. The XED user would
|
||
|
|
/// then have to decide if it was safe to touch the next page and try again
|
||
|
|
/// to decode with more bytes. Also sometimes the user process does not
|
||
|
|
/// have read access to the next page and this allows the user to prevent
|
||
|
|
/// XED from causing process termination by limiting the memory range that
|
||
|
|
/// XED will access.
|
||
|
|
///
|
||
|
|
/// @ingroup DEC
|
||
|
|
XED_DLL_EXPORT xed_error_enum_t
|
||
|
|
xed_decode(xed_decoded_inst_t* xedd,
|
||
|
|
const xed_uint8_t* itext,
|
||
|
|
const unsigned int bytes);
|
||
|
|
|
||
|
|
/// @ingroup DEC
|
||
|
|
/// See #xed_decode(). This version of the decode API adds a CPUID feature
|
||
|
|
/// vector to support restricting decode based on both a specified chip via
|
||
|
|
/// #xed_decoded_inst_set_input_chip() and a modify-able cpuid feature
|
||
|
|
/// vector obtained from #xed_get_chip_features().
|
||
|
|
XED_DLL_EXPORT xed_error_enum_t
|
||
|
|
xed_decode_with_features(xed_decoded_inst_t* xedd,
|
||
|
|
const xed_uint8_t* itext,
|
||
|
|
const unsigned int bytes,
|
||
|
|
xed_chip_features_t* features);
|
||
|
|
|
||
|
|
|
||
|
|
#endif
|
||
|
|
|