RARUN2(1)                   General Commands Manual                  RARUN2(1)

<?><?><?> (NAME)
     rarun2 - <?><?><?><?><?> radare2 <?><?><?><?> <?><?><?><?><?>
     <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
     <?><?><?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
     rarun2 [-vt] [directives ...] [script.rr2] [Fl- program args ...]

<?><?><?><?><?><?><?> (DESCRIPTION)
     <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
     <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
     <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
     <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
     <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>
     <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>.

     <?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
     <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
     <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
     <?><?> <?><?> <?><?><?><?><?><?><?><?><?> '--' <?><?><?><?><?><?><?><?>
     <?><?><?><?><?><?>.

     <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
     <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
     <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
     <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?>
     <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
     <?><?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
     -v          <?><?><?><?><?> <?><?><?><?>

     -t          <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>

     --          <?><?><?><?><?><?><?> <?><?>
                 <?><?><?><?><?><?><?><?><?><?><?>
                 <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
                 <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?><?>
                 <?><?><?><?><?><?>

<?><?><?><?><?><?><?><?><?><?><?><?><?> (DIRECTIVES)
     <?><?><?><?> <?><?><?><?><?><?><?><?> rr2 (rarun2)
     <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?>
     <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
     <?><?><?><?><?><?><?><?> key=value <?><?><?><?><?> <?><?><?> <?>
     <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
     <?><?><?><?><?><?><?><?><?> <?><?> '#' <?><?><?><?>
     <?><?><?><?><?><?><?>.

     program=    <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
                 <?><?><?><?> <?><?><?>

     arg0=..argN=
                 <?><?><?><?><?> <?><?><?><?><?><?>
                 <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
                 <?><?><?><?><?><?>

     aslr=       <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> ASLR
                 (yes|no)

     bits=       <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?> (<?><?>
                 <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>)

     chdir=      <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?>
                 <?><?><?><?><?> <?><?><?><?><?><?>

     chroot=     <?><?><?><?><?> <?><?><?><?><?><?> <?><?> chroot
                 (<?><?><?><?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>)

     clearenv=   <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
                 <?><?><?><?><?> (true|false)

     connect=    <?><?><?><?><?> stdin/stdout/stderr <?><?> <?><?>
                 <?><?><?><?> (host:port)

     core=       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
                 <?><?><?><?> core (true|false)

     daemon=     <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
                 <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
                 (<?><?><?><?><?><?><?>: false)

     envfile=    <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
                 <?><?><?><?><?> 'var=value' <?><?><?> <?><?><?><?><?><?><?>
                 <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
                 <?><?><?><?><?>

     execve=     <?><?><?><?><?><?><?> <?><?> execve <?><?><?><?><?><?>
                 posix_spawn (<?><?><?><?><?><?><?><?> osx)

     fork=       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
                 <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
                 <?><?> 'listen'

     input=      <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
                 <?><?> <?><?><?><?> stdin <?><?> <?><?><?><?><?><?>
                 <?><?><?><?><?> <?><?><?>

     libpath=    <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
                 <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?>
                 <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
                 <?><?><?><?><?> <?><?><?><?><?><?><?>

     listen=     <?><?><?><?> <?><?><?><?> stdin/stdout/stderr <?><?> <?><?>
                 <?><?><?><?> <?><?><?><?> (port)

     maxfd=      <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
                 <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>

     maxproc=    <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
                 <?><?><?><?><?><?><?><?>

     maxstack=   <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
                 <?><?><?><?> <?><?><?><?> (stack)

     nice=       <?><?><?><?><?> <?><?><?> nice (<?><?><?><?><?><?>)
                 <?><?><?><?><?><?>

     pid=        <?><?><?><?><?> pid <?><?><?><?><?><?>

     pidfile=    <?><?><?><?><?> pid <?><?> <?><?> <?><?><?><?>

     preload=    <?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
                 <?><?><?><?><?><?><?><?> (<?><?> Windows
                 <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
                 <?><?> linux<?> osx <?> bsd)

     pty=        <?><?><?><?><?><?><?> <?><?> pty <?><?><?><?> <?><?><?><?><?>
                 <?><?><?> <?><?><?><?> (true|false)

     r2preload=  <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> libr2<?>
                 <?><?><?><?><?><?> kill -USR1 <?><?><?><?> <?><?> r2 <?>
                 <?><?><?><?><?><?> -USR2 <?><?><?><?> <?><?><?><?><?><?><?>

     r2preweb=   <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> thread
                 <?><?><?><?><?> <?><?><?><?> <?><?> r2preload

     runlib=     <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
                 <?><?><?><?> <?><?><?><?> <?><?><?>

     runlib.fcn=
                 <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
                 <?><?><?><?><?><?><?><?><?> runlib <?><?><?><?><?><?><?><?>
                 <?><?><?>

     setegid=    <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?>

     seteuid=    <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?> <?><?><?><?><?><?>

     setenv=     <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
                 <?><?><?><?><?> <?><?><?><?><?><?><?><?> (NAME=VALUE)

     setgid=     <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?>

     setuid=     <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
                 <?><?><?><?><?><?>

     sleep=      <?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
                 <?><?> <?><?><?><?>

     stderrout=  <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
                 <?><?><?><?> stderr <?><?> stdout (true|false)

     stdio=      <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
                 <?><?><?><?> stdout/stderr/stdin

     stdin=      <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> stdin

     stdout=     <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
                 <?><?><?><?> stdout

     stderr=     <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
                 <?><?><?><?> stderr

     system=     <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>

     timeout=    <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
                 <?><?><?><?><?>

     timeoutsig=
                 <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
                 <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
                 <?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
                 (SIGTERM)

     times=      <?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
                 <?><?><?><?><?><?><?><?><?><?> <?><?> stderr (true|false)

     unsetenv=   <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (VALUE PREFIXES)
     <?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
     <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
     <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>:

     @filename   <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
                 <?><?><?><?> <?> <?><?><?><?> <?><?><?><?> <?><?>
                 <?><?><?><?> <?><?><?><?><?> <?><?><?><?>

     text        <?><?><?><?><?><?><?><?><?><?> escape <?><?> <?><?><?><?>
                 <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
                 <?><?><?><?><?>

     'string'    <?><?><?><?><?><?><?><?><?><?> escape <?><?> <?><?><?><?>
                 <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
                 <?><?><?><?><?>

     !cmd        <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
                 <?><?><?><?><?>

     :102030     <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?>
                 <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>

     :!cmd       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
                 <?><?> <?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?><?>
                 <?><?> <?><?> <?><?><?><?><?>

     %1234       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?>
                 <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
                 <?><?> <?><?><?> <?><?><?><?>

     @300@ABCD   <?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> ABCD
                 <?><?> <?><?><?> <?><?><?>

<?><?><?><?> (ENVIRONMENT)
     RARUN2_ARGS
                 <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> "rarun2"
                 <?><?><?> <?><?> <?><?><?><?><?><?>
                 <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
                 <?><?><?><?><?>

<?><?><?><?><?><?><?> (EXAMPLES)
     <?><?><?><?><?> <?><?><?><?><?><?><?> rarun2:

       $ cat foo.rr2
       #!/usr/bin/rarun2
       program=./pp400
       arg0=10
       stdin=foo.txt
       chdir=/tmp
       clearenv=true
       setenv=EGG=eggsy
       setenv=NOFUN=nogames
       unsetenv=NOFUN
       # EGG will be the only env variable
       #chroot=.
       $ ./foo.rr2

     <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>:

       $ nc -l 9999
       $ rarun2 program=/bin/ls connect=localhost:9999

     <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
     <?><?><?><?><?><?><?><?> <?><?><?><?><?>/<?><?><?><?><?> <?><?>
     <?><?><?><?><?><?><?><?> <?><?><?><?>:

       ## open a new terminal and type 'tty' to get
       $ tty ; clear ; sleep 999999
       /dev/ttyS010
       ## in another terminal run r2
       $ r2 -r foo.rr2 -d ls
       $ cat foo.rr2
       #!/usr/bin/rarun2
       stdio=/dev/ttys010
       ## Or you can use -R to set a key=value
       r2 -R stdio=/dev/ttys010 -d ls

     <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> --
     <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?>
     <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
     <?><?><?><?>:

       $ rarun2 timeout=2 -- sleep 4

     <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?>:

       $ rarun2 runlib=/lib/libc-2.25.so runlib.fcn=system arg1="ls /"

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
     radare2(1)

<?><?><?><?><?><?><?><?><?> (AUTHORS)
     <?><?><?><?><?><?><?><?><?> <?><?><?><?> pancake <pancake@nopcode.org>

                                 July 10, 2025