1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
/*
* This file is part of ltrace.
* Copyright (C) 2011,2012 Petr Machata, Red Hat Inc.
*
* 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 2 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, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA
*/
#ifndef FETCH_H
#define FETCH_H
#include "forward.h"
#include "param.h"
/* XXX isn't SYSCALL TOF just a different ABI? Maybe we needed to
* support variant ABIs all along. */
enum tof {
LT_TOF_FUNCTION, /* A real library function */
LT_TOF_FUNCTIONR, /* Return from a real library function */
LT_TOF_SYSCALL, /* A syscall */
LT_TOF_SYSCALLR, /* Return from a syscall */
};
/* The contents of the structure is defined by the back end. */
struct fetch_context;
/* Initialize argument fetching. Returns NULL on failure. RET_INFO
* is the return type of the function. */
struct fetch_context *fetch_arg_init(enum tof type, struct process *proc,
struct arg_type_info *ret_info);
/* Make a clone of context. */
struct fetch_context *fetch_arg_clone(struct process *proc,
struct fetch_context *context);
/* Load next argument. The function returns 0 on success or a
* negative value on failure. The extracted value is stored in
* *VALUEP. */
int fetch_arg_next(struct fetch_context *context, enum tof type,
struct process *proc,
struct arg_type_info *info, struct value *valuep);
/* Load return value. The function returns 0 on success or a negative
* value on failure. The extracted value is stored in *VALUEP. */
int fetch_retval(struct fetch_context *context, enum tof type,
struct process *proc,
struct arg_type_info *info, struct value *valuep);
/* Destroy fetch context. CONTEXT shall be the same memory location
* that was passed to fetch_arg_next. */
void fetch_arg_done(struct fetch_context *context);
/* Called before fetching arguments that come from parameter packs.
* Returns 0 on success or a negative value on failure. */
int fetch_param_pack_start(struct fetch_context *context,
enum param_pack_flavor ppflavor);
/* Called after a parameter pack has been fetched. */
void fetch_param_pack_end(struct fetch_context *context);
/* The following callbacks have to be implemented in backend if arch.h
* defines ARCH_HAVE_FETCH_ARG. These backend callbacks correspond to
* above functions. */
struct fetch_context *arch_fetch_arg_init(enum tof type, struct process *proc,
struct arg_type_info *ret_info);
struct fetch_context *arch_fetch_arg_clone(struct process *proc,
struct fetch_context *context);
int arch_fetch_arg_next(struct fetch_context *ctx, enum tof type,
struct process *proc, struct arg_type_info *info,
struct value *valuep);
int arch_fetch_retval(struct fetch_context *ctx, enum tof type,
struct process *proc, struct arg_type_info *info,
struct value *valuep);
void arch_fetch_arg_done(struct fetch_context *context);
/* The following callbacks have to be implemented in backend if arch.h
* defines ARCH_HAVE_FETCH_ARG and ARCH_HAVE_FETCH_PACK. */
int arch_fetch_param_pack_start(struct fetch_context *context,
enum param_pack_flavor ppflavor);
void arch_fetch_param_pack_end(struct fetch_context *context);
#endif /* FETCH_H */
|
