mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2025-01-12 12:16:04 +08:00
e9076973c8
When setting a syscall catchpoint by name, catch syscalls whose name or alias matches the requested string. When the ABI of a system call is changed in the FreeBSD kernel, this is implemented by leaving a compatibility system call using the old ABI at the existing "slot" and allocating a new system call for the version using the new ABI. For example, new fields were added to the 'struct kevent' used by the kevent() system call in FreeBSD 12. The previous kevent() system call in FreeBSD 12 kernels is now called freebsd11_kevent() and is still used by older binaries compiled against the older ABI. The freebsd11_kevent() system call can be tagged with an "alias" attribute of "kevent" permitting 'catch syscall kevent' to catch both system calls and providing the expected user behavior for both old and new binaries. It also provides the expected behavior if GDB is compiled on an older host (such as a FreeBSD 11 host). gdb/ChangeLog: * NEWS: Add entry documenting system call aliases. * break-catch-syscall.c (catch_syscall_split_args): Pass 'result' to get_syscalls_by_name. * gdbarch.sh (UNKNOWN_SYSCALL): Remove. * gdbarch.h: Regenerate. * syscalls/gdb-syscalls.dtd (syscall): Add alias attribute. * xml-syscall.c [!HAVE_LIBEXPAT] (get_syscalls_by_name): Rename from get_syscall_by_name. Now accepts a pointer to a vector of integers and returns a bool. [HAVE_LIBEXPAT] (struct syscall_desc): Add alias member. (syscall_create_syscall_desc): Add alias parameter and pass it to syscall_desc constructor. (syscall_start_syscall): Handle alias attribute. (syscall_attr): Add alias attribute. (xml_get_syscalls_by_name): Rename from xml_get_syscall_number. Now accepts a pointer to a vector of integers and returns a bool. Add syscalls whose alias or name matches the requested name. (get_syscalls_by_name): Rename from get_syscall_by_name. Now accepts a pointer to a vector of integers and returns a bool. * xml-syscall.h (get_syscalls_by_name): Likewise. gdb/doc/ChangeLog: * gdb.texinfo (Set Catchpoints): Add an anchor for 'catch syscall'. (Native): Add a FreeBSD subsection. (FreeBSD): Document use of system call aliases for compatibility system calls.
70 lines
2.7 KiB
C++
70 lines
2.7 KiB
C++
/* Functions that provide the mechanism to parse a syscall XML file
|
|
and get its values.
|
|
|
|
Copyright (C) 2009-2018 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 XML_SYSCALL_H
|
|
#define XML_SYSCALL_H 1
|
|
|
|
/* Function used to set the name of the file which contains
|
|
information about the system calls present in the current
|
|
architecture.
|
|
|
|
This function *should* be called before anything else, otherwise
|
|
GDB won't be able to find the correct XML file to open and get
|
|
the syscalls definitions. */
|
|
|
|
void set_xml_syscall_file_name (struct gdbarch *gdbarch,
|
|
const char *name);
|
|
|
|
/* Function that retrieves the syscall name corresponding to the given
|
|
number. It puts the requested information inside 'struct syscall'. */
|
|
|
|
void get_syscall_by_number (struct gdbarch *gdbarch,
|
|
int syscall_number, struct syscall *s);
|
|
|
|
/* Function that retrieves the syscall numbers corresponding to the
|
|
given name. The numbers of all syscalls with either a name or
|
|
alias equal to SYSCALL_NAME are appended to SYSCALL_NUMBERS. If no
|
|
matching syscalls are found, return false. */
|
|
|
|
bool get_syscalls_by_name (struct gdbarch *gdbarch, const char *syscall_name,
|
|
std::vector<int> *syscall_numbers);
|
|
|
|
/* Function used to retrieve the list of syscalls in the system. This list
|
|
is returned as an array of strings. Returns the list of syscalls in the
|
|
system, or NULL otherwise. */
|
|
|
|
const char **get_syscall_names (struct gdbarch *gdbarch);
|
|
|
|
/* Function used to retrieve the list of syscalls of a given group in
|
|
the system. The syscall numbers are appended to SYSCALL_NUMBERS.
|
|
If the group doesn't exist, return false. */
|
|
|
|
bool get_syscalls_by_group (struct gdbarch *gdbarch, const char *group,
|
|
std::vector<int> *syscall_numbers);
|
|
|
|
/* Function used to retrieve the list of syscall groups in the system.
|
|
Return an array of strings terminated by a NULL element. The list
|
|
must be freed by the caller. Return NULL if there is no syscall
|
|
information available. */
|
|
|
|
const char **get_syscall_group_names (struct gdbarch *gdbarch);
|
|
|
|
#endif /* XML_SYSCALL_H */
|