X-Git-Url: http://drtracing.org/?a=blobdiff_plain;f=gdb%2Futils.h;h=3434ff1caa25046dd4a781701ccc22b247c054f6;hb=a350efd4fb368a35ada608f6bc26ccd3bed0ae6b;hp=d3b8871b58220286d2148ff2f1fa6a0144fb24e4;hpb=459a2e4ccf9aadfba9819facba1c9be5297c1625;p=deliverable%2Fbinutils-gdb.git diff --git a/gdb/utils.h b/gdb/utils.h index d3b8871b58..3434ff1caa 100644 --- a/gdb/utils.h +++ b/gdb/utils.h @@ -1,7 +1,7 @@ /* *INDENT-OFF* */ /* ATTRIBUTE_PRINTF confuses indent, avoid running it for now. */ /* I/O, string, cleanup, and other random utilities for GDB. - Copyright (C) 1986-2018 Free Software Foundation, Inc. + Copyright (C) 1986-2020 Free Software Foundation, Inc. This file is part of GDB. @@ -22,14 +22,19 @@ #define UTILS_H #include "exceptions.h" -#include "common/scoped_restore.h" +#include "gdbsupport/scoped_restore.h" #include -extern void initialize_utils (void); +#ifdef HAVE_LIBXXHASH +#include +#endif + +struct completion_match_for_lcd; +class compiled_regex; /* String utilities. */ -extern int sevenbit_strings; +extern bool sevenbit_strings; /* Modes of operation for strncmp_iw_with_mode. */ @@ -100,9 +105,6 @@ extern int streq_hash (const void *, const void *); extern int subset_compare (const char *, const char *); -int compare_positive_ints (const void *ap, const void *bp); -int compare_strings (const void *ap, const void *bp); - /* Compare C strings for std::sort. */ static inline bool @@ -116,14 +118,14 @@ compare_cstrings (const char *str1, const char *str2) MATCHING, if non-NULL, is the corresponding argument to bfd_check_format_matches, and will be freed. */ -extern const char *gdb_bfd_errmsg (bfd_error_type error_tag, char **matching); +extern std::string gdb_bfd_errmsg (bfd_error_type error_tag, char **matching); /* Reset the prompt_for_continue clock. */ void reset_prompt_for_continue_wait_time (void); /* Return the time spent in prompt_for_continue. */ std::chrono::steady_clock::duration get_prompt_for_continue_wait_time (); -/* Parsing utilites. */ +/* Parsing utilities. */ extern int parse_pid_to_attach (const char *args); @@ -144,10 +146,7 @@ public: } /* A constructor that calls buildargv on STR. STR may be NULL, in - which case this object is initialized with a NULL array. If - buildargv fails due to out-of-memory, call malloc_failure. - Therefore, the value is guaranteed to be non-NULL, unless the - parameter itself is NULL. */ + which case this object is initialized with a NULL array. */ explicit gdb_argv (const char *str) : m_argv (NULL) @@ -189,7 +188,7 @@ public: /* Return the underlying array, transferring ownership to the caller. */ - char **release () + ATTRIBUTE_UNUSED_RESULT char **release () { char **result = m_argv; m_argv = NULL; @@ -249,10 +248,6 @@ private: /* Cleanup utilities. */ -/* For make_cleanup_close see common/filestuff.h. */ - -extern struct cleanup *make_cleanup_value_free_to_mark (struct value *); - /* A deleter for a hash table. */ struct htab_deleter { @@ -265,8 +260,6 @@ struct htab_deleter /* A unique_ptr wrapper for htab_t. */ typedef std::unique_ptr htab_up; -extern void free_current_contents (void *); - extern void init_page_info (void); /* Temporarily set BATCH_FLAG and the associated unlimited terminal size. @@ -291,7 +284,6 @@ private: int m_save_batch_flag; }; -extern struct cleanup *make_bpstat_clear_actions_cleanup (void); /* Path utilities. */ @@ -321,13 +313,19 @@ extern void wrap_here (const char *); extern void reinitialize_more_filter (void); -extern int pagination_enabled; +extern bool pagination_enabled; extern struct ui_file **current_ui_gdb_stdout_ptr (void); extern struct ui_file **current_ui_gdb_stdin_ptr (void); extern struct ui_file **current_ui_gdb_stderr_ptr (void); extern struct ui_file **current_ui_gdb_stdlog_ptr (void); +/* Flush STREAM. This is a wrapper for ui_file_flush that also + flushes any output pending from uses of the *_filtered output + functions; that output is kept in a special buffer so that + pagination and styling are handled properly. */ +extern void gdb_flush (struct ui_file *); + /* The current top level's ui_file streams. */ /* Normal results */ @@ -357,7 +355,10 @@ extern struct ui_file *gdb_stdtargin; extern void set_screen_width_and_height (int width, int height); /* More generic printf like operations. Filtered versions may return - non-locally on error. */ + non-locally on error. As an extension over plain printf, these + support some GDB-specific format specifiers. Particularly useful + here are the styling formatters: '%p[', '%p]' and '%ps'. See + ui_out::message for details. */ extern void fputs_filtered (const char *, struct ui_file *); @@ -419,12 +420,61 @@ extern void fputstr_unfiltered (const char *str, int quotr, extern void fputstrn_filtered (const char *str, int n, int quotr, struct ui_file * stream); +typedef int (*do_fputc_ftype) (int c, ui_file *stream); + extern void fputstrn_unfiltered (const char *str, int n, int quotr, + do_fputc_ftype do_fputc, struct ui_file * stream); /* Return nonzero if filtered printing is initialized. */ extern int filtered_printing_initialized (void); +/* Like fprintf_filtered, but styles the output according to STYLE, + when appropriate. */ + +extern void fprintf_styled (struct ui_file *stream, + const ui_file_style &style, + const char *fmt, + ...) + ATTRIBUTE_PRINTF (3, 4); + +extern void vfprintf_styled (struct ui_file *stream, + const ui_file_style &style, + const char *fmt, + va_list args) + ATTRIBUTE_PRINTF (3, 0); + +/* Like vfprintf_styled, but do not process gdb-specific format + specifiers. */ +extern void vfprintf_styled_no_gdbfmt (struct ui_file *stream, + const ui_file_style &style, + bool filter, + const char *fmt, va_list args) + ATTRIBUTE_PRINTF (4, 0); + +/* Like fputs_filtered, but styles the output according to STYLE, when + appropriate. */ + +extern void fputs_styled (const char *linebuffer, + const ui_file_style &style, + struct ui_file *stream); + +/* Unfiltered variant of fputs_styled. */ + +extern void fputs_styled_unfiltered (const char *linebuffer, + const ui_file_style &style, + struct ui_file *stream); + +/* Like fputs_styled, but uses highlight_style to highlight the + parts of STR that match HIGHLIGHT. */ + +extern void fputs_highlighted (const char *str, const compiled_regex &highlight, + struct ui_file *stream); + +/* Reset the terminal style to the default, if needed. */ + +extern void reset_terminal_style (struct ui_file *stream); + /* Display the host ADDR on STREAM formatted as ``0x%x''. */ extern void gdb_print_host_address_1 (const void *addr, struct ui_file *stream); @@ -492,38 +542,6 @@ extern pid_t wait_to_die_with_timeout (pid_t pid, int *status, int timeout); extern int myread (int, char *, int); -/* Ensure that V is aligned to an N byte boundary (B's assumed to be a - power of 2). Round up/down when necessary. Examples of correct - use include: - - addr = align_up (addr, 8); -- VALUE needs 8 byte alignment - write_memory (addr, value, len); - addr += len; - - and: - - sp = align_down (sp - len, 16); -- Keep SP 16 byte aligned - write_memory (sp, value, len); - - Note that uses such as: - - write_memory (addr, value, len); - addr += align_up (len, 8); - - and: - - sp -= align_up (len, 8); - write_memory (sp, value, len); - - are typically not correct as they don't ensure that the address (SP - or ADDR) is correctly aligned (relying on previous alignment to - keep things right). This is also why the methods are called - "align_..." instead of "round_..." as the latter reads better with - this incorrect coding style. */ - -extern ULONGEST align_up (ULONGEST v, int n); -extern ULONGEST align_down (ULONGEST v, int n); - /* Resource limits used by getrlimit and setrlimit. */ enum resource_limit_kind @@ -548,9 +566,27 @@ extern void warn_cant_dump_core (const char *reason); extern void dump_core (void); -/* Return the hex string form of LENGTH bytes of DATA. - Space for the result is malloc'd, caller must free. */ +/* Copy NBITS bits from SOURCE to DEST starting at the given bit + offsets. Use the bit order as specified by BITS_BIG_ENDIAN. + Source and destination buffers must not overlap. */ + +extern void copy_bitwise (gdb_byte *dest, ULONGEST dest_offset, + const gdb_byte *source, ULONGEST source_offset, + ULONGEST nbits, int bits_big_endian); -extern char *make_hex_string (const gdb_byte *data, size_t length); +/* A fast hashing function. This can be used to hash data in a fast way + when the length is known. If no fast hashing library is available, falls + back to iterative_hash from libiberty. START_VALUE can be set to + continue hashing from a previous value. */ + +static inline unsigned int +fast_hash (const void *ptr, size_t len, unsigned int start_value = 0) +{ +#ifdef HAVE_LIBXXHASH + return XXH64 (ptr, len, start_value); +#else + return iterative_hash (ptr, len, start_value); +#endif +} #endif /* UTILS_H */