1461b486abbb14c5fe4ad10e86ac2a921d486203

Build # 1461b486abbb14c5fe4ad10e86ac2a921d486203

Build Type

push

github-actions

Committed by GitHub

Commit Message

Fix documentation of tube.recvall (#2163)

Run Details

3873 of 6370 branches covered (60.8%)

12198 of 16609 relevant lines covered (73.44%)

0.73 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

23.19

/pwnlib/commandline/debug.py

#!/usr/bin/env python2
from __future__ import absolute_import
from __future__ import division

import argparse
import sys

from pwn import *
from pwnlib.commandline import common

parser = common.parser_commands.add_parser(
    'debug',
    help = 'Debug a binary in GDB',
    description = 'Debug a binary in GDB'
)
parser.add_argument(
    '-x', metavar='GDBSCRIPT',
    type=argparse.FileType('r'),
    help='Execute GDB commands from this file.'
)
parser.add_argument(
    '--pid',
    type=int,
    help="PID to attach to"
)
parser.add_argument(
    '-c', '--context',
    metavar = 'context',
    action = 'append',
    type   = common.context_arg,
    choices = common.choices,
    help = 'The os/architecture/endianness/bits the shellcode will run in (default: linux/i386), choose from: %s' % common.choices,
)
parser.add_argument(
    '--exec',

    # NOTE: Type cannot be "file" because we may be referring to a remote
    #       file, or a file on an Android device.
    type=str,

    dest='executable',
    help='File to debug'
)
parser.add_argument(
    '--process', metavar='PROCESS_NAME',
    help='Name of the process to attach to (e.g. "bash")'
)
parser.add_argument(
    '--sysroot', metavar='SYSROOT',
    type=str,
    default='',
    help="GDB sysroot path"
)

def main(args):
    gdbscript = ''
    if args.x:
        gdbscript = args.x.read()

    if context.os == 'android':
        context.device = adb.wait_for_device()

    if args.executable:
        if os.path.exists(args.executable):
            context.binary = ELF(args.executable)
            target = context.binary.path

        # This path does nothing, but avoids the "print_usage()"
        # path below.
        elif context.os == 'android':
            target = args.executable
    elif args.pid:
        target = int(args.pid)
    elif args.process:
        if context.os == 'android':
            target = adb.pidof(args.process)
        else:
            target = pidof(args.process)

        # pidof() returns a list
        if not target:
            log.error("Could not find a PID for %r", args.process)

        target = target[0]

        # pidof will sometimes return all PIDs, including init
        if target == 1:
            log.error("Got PID 1 from pidof.  Check the process name, or use --pid 1 to debug init")
    else:
        parser.print_usage()
        return 1

    if args.pid or args.process:
        pid = gdb.attach(target, gdbscript=gdbscript, sysroot=args.sysroot)

        # Since we spawned the gdbserver process, and process registers an
        # atexit handler to close itself, gdbserver will be terminated when
        # we exit.  This will manifest as a "remote connected ended" or
        # similar error message.  Hold it open for the user.
        log.info("GDB connection forwarding will terminate when you press enter")
        pause()
    else:
        gdb.debug(target, gdbscript=gdbscript, sysroot=args.sysroot).interactive()

if __name__ == '__main__':
    pwnlib.commandline.common.main(__file__)

1	#!/usr/bin/env python2
2	from __future__ import absolute_import	1✔
3	from __future__ import division	1✔
4
5	import argparse	1✔
6	import sys	1✔
7
8	from pwn import *	1✔
9	from pwnlib.commandline import common	1✔
10
11	parser = common.parser_commands.add_parser(	1✔
12	'debug',
13	help = 'Debug a binary in GDB',
14	description = 'Debug a binary in GDB'
15	)
16	parser.add_argument(	1✔
17	'-x', metavar='GDBSCRIPT',
18	type=argparse.FileType('r'),
19	help='Execute GDB commands from this file.'
20	)
21	parser.add_argument(	1✔
22	'--pid',
23	type=int,
24	help="PID to attach to"
25	)
26	parser.add_argument(	1✔
27	'-c', '--context',
28	metavar = 'context',
29	action = 'append',
30	type = common.context_arg,
31	choices = common.choices,
32	help = 'The os/architecture/endianness/bits the shellcode will run in (default: linux/i386), choose from: %s' % common.choices,
33	)
34	parser.add_argument(	1✔
35	'--exec',
36
37	# NOTE: Type cannot be "file" because we may be referring to a remote
38	# file, or a file on an Android device.
39	type=str,
40
41	dest='executable',
42	help='File to debug'
43	)
44	parser.add_argument(	1✔
45	'--process', metavar='PROCESS_NAME',
46	help='Name of the process to attach to (e.g. "bash")'
47	)
48	parser.add_argument(	1✔
49	'--sysroot', metavar='SYSROOT',
50	type=str,
51	default='',
52	help="GDB sysroot path"
53	)
54
55	def main(args):	1✔
56	gdbscript = ''	×
57	if args.x:	×
58	gdbscript = args.x.read()	×
59
60	if context.os == 'android':	×
61	context.device = adb.wait_for_device()	×
62
63	if args.executable:	×
64	if os.path.exists(args.executable):	×
65	context.binary = ELF(args.executable)	×
66	target = context.binary.path	×
67
68	# This path does nothing, but avoids the "print_usage()"
69	# path below.
70	elif context.os == 'android':	×
71	target = args.executable	×
72	elif args.pid:	×
73	target = int(args.pid)	×
74	elif args.process:	×
75	if context.os == 'android':	×
76	target = adb.pidof(args.process)	×
77	else:
78	target = pidof(args.process)	×
79
80	# pidof() returns a list
81	if not target:	×
82	log.error("Could not find a PID for %r", args.process)	×
83
84	target = target[0]	×
85
86	# pidof will sometimes return all PIDs, including init
87	if target == 1:	×
88	log.error("Got PID 1 from pidof. Check the process name, or use --pid 1 to debug init")	×
89	else:
90	parser.print_usage()	×
91	return 1	×
92
93	if args.pid or args.process:	×
94	pid = gdb.attach(target, gdbscript=gdbscript, sysroot=args.sysroot)	×
95
96	# Since we spawned the gdbserver process, and process registers an
97	# atexit handler to close itself, gdbserver will be terminated when
98	# we exit. This will manifest as a "remote connected ended" or
99	# similar error message. Hold it open for the user.
100	log.info("GDB connection forwarding will terminate when you press enter")	×
101	pause()	×
102	else:
103	gdb.debug(target, gdbscript=gdbscript, sysroot=args.sysroot).interactive()	×
104
105	if __name__ == '__main__':	1!
106	pwnlib.commandline.common.main(__file__)	×

Gallopsled / pwntools / 1461b486abbb14c5fe4ad10e86ac2a921d486203

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous