2002-04-09 Daniel Jacobowitz <drow@mvista.com>
[external/binutils.git] / gdb / gdbserver / server.h
1 /* Common definitions for remote server for GDB.
2    Copyright 1993, 1995, 1997, 1998, 1999, 2000, 2002
3    Free Software Foundation, Inc.
4
5    This file is part of GDB.
6
7    This program is free software; you can redistribute it and/or modify
8    it under the terms of the GNU General Public License as published by
9    the Free Software Foundation; either version 2 of the License, or
10    (at your option) any later version.
11
12    This program is distributed in the hope that it will be useful,
13    but WITHOUT ANY WARRANTY; without even the implied warranty of
14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15    GNU General Public License for more details.
16
17    You should have received a copy of the GNU General Public License
18    along with this program; if not, write to the Free Software
19    Foundation, Inc., 59 Temple Place - Suite 330,
20    Boston, MA 02111-1307, USA.  */
21
22 #ifndef SERVER_H
23 #define SERVER_H
24
25 #include "config.h"
26
27 #include <stdarg.h>
28 #include <stdio.h>
29 #include <stdlib.h>
30 #include <errno.h>
31 #include <setjmp.h>
32
33 #ifndef ATTR_NORETURN
34 #if defined(__GNUC__) && (__GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 7))
35 #define ATTR_NORETURN __attribute__ ((noreturn))
36 #else
37 #define ATTR_NORETURN           /* nothing */
38 #endif
39 #endif
40
41 #ifndef ATTR_FORMAT
42 #if defined(__GNUC__) && (__GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 4))
43 #define ATTR_FORMAT(type, x, y) __attribute__ ((format(type, x, y)))
44 #else
45 #define ATTR_FORMAT(type, x, y) /* nothing */
46 #endif
47 #endif
48
49 /* FIXME: This should probably be autoconf'd for.  It's an integer type at
50    least the size of a (void *).  */
51 typedef long long CORE_ADDR;
52
53 #include "regcache.h"
54 #include "gdb/signals.h"
55
56
57 /* Target-specific functions */
58
59 int create_inferior (char *program, char **allargs);
60 void kill_inferior (void);
61 void fetch_inferior_registers (int regno);
62 void store_inferior_registers (int regno);
63 int mythread_alive (int pid);
64 void myresume (int step, int signo);
65 unsigned char mywait (char *status);
66 void read_inferior_memory (CORE_ADDR memaddr, char *myaddr, int len);
67 int write_inferior_memory (CORE_ADDR memaddr, char *myaddr, int len);
68 int create_inferior ();
69 void initialize_low ();
70
71 /* Target-specific variables */
72
73 extern char *registers;
74
75 /* Public variables in server.c */
76
77 extern int cont_thread;
78 extern int general_thread;
79 extern int thread_from_wait;
80 extern int old_thread_from_wait;
81
82 extern jmp_buf toplevel;
83 extern int inferior_pid;
84
85 /* Functions from remote-utils.c */
86
87 int putpkt (char *buf);
88 int getpkt (char *buf);
89 void remote_open (char *name);
90 void remote_close (void);
91 void write_ok (char *buf);
92 void write_enn (char *buf);
93 void enable_async_io (void);
94 void disable_async_io (void);
95 void convert_ascii_to_int (char *from, char *to, int n);
96 void convert_int_to_ascii (char *from, char *to, int n);
97 void prepare_resume_reply (char *buf, char status, unsigned char sig);
98
99 void decode_m_packet (char *from, CORE_ADDR * mem_addr_ptr,
100                       unsigned int *len_ptr);
101 void decode_M_packet (char *from, CORE_ADDR * mem_addr_ptr,
102                       unsigned int *len_ptr, char *to);
103
104 /* Functions from ``signals.c''.  */
105 enum target_signal target_signal_from_host (int hostsig);
106 int target_signal_to_host_p (enum target_signal oursig);
107 int target_signal_to_host (enum target_signal oursig);
108
109 /* Functions from utils.c */
110
111 void perror_with_name (char *string);
112 void error (const char *string,...) ATTR_NORETURN;
113 void fatal (const char *string,...) ATTR_NORETURN;
114 void warning (const char *string,...);
115
116 /* Functions from the register cache definition.  */
117
118 void init_registers (void);
119
120 /* Maximum number of bytes to read/write at once.  The value here
121    is chosen to fill up a packet (the headers account for the 32).  */
122 #define MAXBUFBYTES(N) (((N)-32)/2)
123
124 /* Buffer sizes for transferring memory, registers, etc.  Round up PBUFSIZ to
125    hold all the registers, at least.  */
126 #define PBUFSIZ ((registers_length () + 32 > 2000) \
127                  ? (registers_length () + 32) \
128                  : 2000)
129
130 #endif /* SERVER_H */