/* Target description related code for GNU/Linux x86 (i386 and x86-64).

   Copyright (C) 2024-2025 Free Software Foundation, Inc.

   This file is part of GDB.

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 3 of the License, or
   (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program.  If not, see <http://www.gnu.org/licenses/>.  */

#ifndef GDB_ARCH_X86_LINUX_TDESC_FEATURES_H
#define GDB_ARCH_X86_LINUX_TDESC_FEATURES_H

#include "gdbsupport/x86-xstate.h"
#include "gdbsupport/gdb_assert.h"

/* Return a mask of X86_STATE_* feature flags.  The returned mask indicates
   the set of features which are checked for when creating the target
   description for each of amd64, x32, and i386.  */

extern uint64_t x86_linux_amd64_xcr0_feature_mask ();
extern uint64_t x86_linux_x32_xcr0_feature_mask ();
extern uint64_t x86_linux_i386_xcr0_feature_mask ();

#ifdef GDBSERVER

/* Convert an xcr0 value into an integer.  The integer will be passed from
   gdbserver to the in-process-agent where it will then be passed through
   x86_linux_tdesc_idx_to_xcr0 to get back the original xcr0 value.  */

extern int x86_linux_xcr0_to_tdesc_idx (uint64_t xcr0);

#endif /* GDBSERVER */

#ifdef IN_PROCESS_AGENT

/* Return the maximum possible number of target descriptions for each of
   amd64, x32, and i386.  These are used by the in-process-agent to
   generate every possible target description.  */

extern int x86_linux_amd64_tdesc_count ();
extern int x86_linux_x32_tdesc_count ();
extern int x86_linux_i386_tdesc_count ();

/* Convert an index number (as returned from x86_linux_xcr0_to_tdesc_idx)
   into an xcr0 value which can then be used to create a target
   description.  */

extern uint64_t x86_linux_tdesc_idx_to_xcr0 (int idx);

#endif /* IN_PROCESS_AGENT */

#endif /* GDB_ARCH_X86_LINUX_TDESC_FEATURES_H */