summaryrefslogtreecommitdiff
path: root/README.md
blob: 7d8ba53de51e4de0acbaabab0ac500d47c8e8d8d (plain)
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
# runcode

execute raw binary code from a file

# Synopsis

`runcode file`

# Description

The `runcode` utility loads an arbitrary binary file into memory and attempts
to execute it. This is useful for testing shellcode used in penetration
testing.

# Options

None.

# Operands

`file` A file containing executable instructions.

# STDIN

Not used by `runcode` itself. May be used by the loaded program.

# Input Files

The input file must be contain valid executable instructions appropriate
to architecture `runcode` is being executed on.

# STDOUT

Not used by `runcode` itself. May be used by the loaded program.

# STDERR

Used for diagnostic messages.

# Output Files

None.

# Extended Description

None.

# Exit Status

0	Successful completion.
>0	An error occurred.

# Consequence of Errors

If the file specified cannot be opened for reading or mapped for execution,
a diagnostic message will be printed to standard error. Behavior is undefined
if the file specified does not contain an executable instruction at its first
byte.