From: Tom Tromey Date: Mon, 20 Jan 2014 17:38:07 +0000 (-0700) Subject: update rsp-low comments X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=9d2d0b8b042cfb82c2ac600bff13f473a78a4c7f;p=binutils-gdb.git update rsp-low comments This updates all the comments in rsp-low.[ch], now that the unification has been completed. 2014-02-12 Tom Tromey * common/rsp-low.c: Update comments. * common/rsp-low.h: Update comments. --- diff --git a/gdb/ChangeLog b/gdb/ChangeLog index fb8100a3017..f8582a1a57e 100644 --- a/gdb/ChangeLog +++ b/gdb/ChangeLog @@ -1,3 +1,8 @@ +2014-02-12 Tom Tromey + + * common/rsp-low.c: Update comments. + * common/rsp-low.h: Update comments. + 2014-02-12 Tom Tromey * common/rsp-low.c (convert_ascii_to_int): Remove. diff --git a/gdb/common/rsp-low.c b/gdb/common/rsp-low.c index ecaa69a52ef..b777716e059 100644 --- a/gdb/common/rsp-low.c +++ b/gdb/common/rsp-low.c @@ -27,7 +27,7 @@ #include "rsp-low.h" -/* Convert hex digit A to a number. */ +/* See rsp-low.h. */ int fromhex (int a) @@ -42,6 +42,8 @@ fromhex (int a) error (_("Reply contains invalid hex digit %d"), a); } +/* See rsp-low.h. */ + int tohex (int nib) { @@ -76,6 +78,8 @@ ishex (int ch, int *val) return 0; } +/* See rsp-low.h. */ + char * pack_nibble (char *buf, int nibble) { @@ -83,6 +87,8 @@ pack_nibble (char *buf, int nibble) return buf; } +/* See rsp-low.h. */ + char * pack_hex_byte (char *pkt, int byte) { @@ -91,6 +97,8 @@ pack_hex_byte (char *pkt, int byte) return pkt; } +/* See rsp-low.h. */ + char * unpack_varlen_hex (char *buff, /* packet to parse */ ULONGEST *result) @@ -108,6 +116,8 @@ unpack_varlen_hex (char *buff, /* packet to parse */ return buff; } +/* See rsp-low.h. */ + int hex2bin (const char *hex, gdb_byte *bin, int count) { @@ -127,6 +137,8 @@ hex2bin (const char *hex, gdb_byte *bin, int count) return i; } +/* See rsp-low.h. */ + int bin2hex (const gdb_byte *bin, char *hex, int count) { @@ -141,6 +153,8 @@ bin2hex (const gdb_byte *bin, char *hex, int count) return i; } +/* See rsp-low.h. */ + int remote_escape_output (const gdb_byte *buffer, int len, gdb_byte *out_buf, int *out_len, @@ -173,6 +187,8 @@ remote_escape_output (const gdb_byte *buffer, int len, return output_index; } +/* See rsp-low.h. */ + int remote_unescape_input (const gdb_byte *buffer, int len, gdb_byte *out_buf, int out_maxlen) diff --git a/gdb/common/rsp-low.h b/gdb/common/rsp-low.h index 9edf4dc6966..31162c69776 100644 --- a/gdb/common/rsp-low.h +++ b/gdb/common/rsp-low.h @@ -28,14 +28,35 @@ extern int fromhex (int a); extern int tohex (int nib); +/* Write a character representing the low order four bits of NIBBLE in + hex to *BUF. Returns BUF+1. */ + extern char *pack_nibble (char *buf, int nibble); +/* Write the low byte of BYTE in hex to *BUF. Returns BUF+2. */ + extern char *pack_hex_byte (char *pkt, int byte); +/* Read hex digits from BUFF and convert to a number, which is stored + in RESULT. Reads until a non-hex digit is seen. Returns a pointer + to the terminating character. */ + extern char *unpack_varlen_hex (char *buff, ULONGEST *result); +/* HEX is a string of characters representing hexadecimal digits. + Convert pairs of hex digits to bytes and store sequentially into + BIN. COUNT is the maximum number of characters to convert. This + will convert fewer characters if the number of hex characters + actually seen is odd, or if HEX terminates before COUNT characters. + Returns the number of characters actually converted. */ + extern int hex2bin (const char *hex, gdb_byte *bin, int count); +/* Convert some bytes to a hexadecimal representation. BIN holds the + bytes to convert. COUNT says how many bytes to convert. The + resulting characters are stored in HEX, followed by a NUL + character. Returns the number of bytes actually converted. */ + extern int bin2hex (const gdb_byte *bin, char *hex, int count); /* Convert BUFFER, binary data at least LEN bytes long, into escaped