RZ_RUN(1)                   General Commands Manual                  RZ_RUN(1)

<?><?><?> (NAME)
     rz-run - <?><?><?><?><?> rizin <?><?><?><?> <?><?><?><?><?>
     <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
     <?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
     rz-run [[directives]] [[script.rz]] [[--] [program] [args]]

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

     <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
     <?><?><?><?><?><?><?><?><?> (launcher) <?><?><?><?> <?><?><?><?><?>
     <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
     <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
     <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?>
     <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> (file
     descriptors) <?><?><?><?><?><?><?>
     <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
     <?><?><?> <?><?><?><?><?><?>.

     -l          <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (profile)
                 <?><?><?><?><?><?><?><?><?><?><?><?>.

     -t          <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
                 <?><?><?><?>. <?><?><?><?><?> rz-run -d > profile.rz <?><?>
                 <?><?><?><?><?><?> <?><?><?><?>

     -w          <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?>
                 <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
                 <?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?><?><?> rz-run
                 stdio=<ttypath> program=/bin/sh <?><?> <?><?><?><?><?><?>
                 <?><?><?><?>

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

     <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
     <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
     <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
     <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
     <?><?> stdin <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
     <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
     <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
     (crackmes) <?><?><?><?> <?><?><?> :)

<?><?><?><?><?><?><?><?><?><?><?><?><?> (DIRECTIVES)
     <?><?><?><?> <?><?><?><?><?><?><?><?> rrz (rz-run)
     <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?>
     <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
     <?><?><?><?><?><?><?><?> key=value <?><?><?><?><?> <?><?><?> <?>
     <?><?><?><?> <?><?><?><?><?><?><?> <?><?> '#' <?><?> <?><?><?><?><?>
     <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

     arg[0-511]  <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?><?> N <?><?><?><?><?><?> <?><?>
                 <?><?><?><?><?><?>

     aslr        <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> ASLR

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

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

     chroot      <?><?><?><?><?> <?><?><?><?><?><?> <?><?> chroot<?>
                 <?><?><?><?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
                 <?><?><?>

     core        <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
                 <?><?><?><?> core

     connect     <?><?><?><?><?> stdin/stdout/stderr <?><?> <?><?>
                 <?><?><?><?>

     pty         <?><?><?><?><?><?><?> <?><?> <?><?> pty <?><?><?><?>
                 <?><?><?><?><?> <?><?><?> <?><?><?><?> (<?><?>
                 <?><?><?><?><?> connect/listen)

     envfile     <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?> <?><?><?><?><?> `var=value` <?><?><?><?>
                 <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
                 <?><?><?><?><?><?><?><?> <?><?><?><?><?>

     fork        <?><?> <?><?><?><?><?> <?><?><?><?><?> listen
                 <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?>
                 <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
                 <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
                 <?><?><?>. <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
                 (debugging) <?><?><?><?><?><?> <?><?><?><?><?>
                 <?><?><?><?><?><?>.

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

     libpath     <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
                 <?><?><?><?><?><?><?> <?><?><?><?> (dynamic loader) <?><?>
                 <?><?> <?><?> <?><?><?><?><?>
                 <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
                 <?><?><?><?><?><?><?>

     listen      <?><?><?><?><?> <?><?><?><?> stdin/stdout/stderr <?><?>
                 <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> (listening
                 socket)

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

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

     maxfd       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
                 <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
                 (file descriptors)

     nice        <?><?><?><?><?> <?><?><?> niceness (<?><?><?><?><?><?>
                 <?><?><?><?><?><?>) <?><?><?><?><?><?>

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

     daemon      <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?> false
                 <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?>
                 <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
                 <?><?><?><?><?><?><?><?> <?> <?><?><?> <?><?>
                 <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>.

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

     pid         <?><?><?><?><?> <?><?><?> true <?><?><?><?> <?><?><?> PID
                 <?><?><?><?><?><?> <?><?> stderr

     pidfile     <?><?><?> PID <?><?><?><?><?><?> <?><?> <?><?><?><?>
                 <?><?><?><?><?><?><?><?>

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

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

     rzpreload   <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> librz<?>
                 <?><?><?><?><?> <?><?><?><?><?><?> kill -USR1 <?><?><?><?>
                 <?><?><?><?><?><?> <?><?> rizin <?><?> -USRZ <?><?><?><?>
                 <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
                 <?><?> <?><?><?><?> (thread)

     setenv      <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
                 <?><?><?><?><?> <?><?><?><?><?><?><?><?>

     setegid     <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?> <?><?><?><?> (effective group ID)

     seteuid     <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
                 <?><?><?><?><?><?> <?><?><?><?> (effective user ID)

     setgid      <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?> (group ID)

     setuid      <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
                 <?><?><?><?><?><?> (user ID)

     sleep       <?><?><?><?><?><?><?> (<?><?><?><?> <?><?><?><?>) <?><?>
                 <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
                 <?><?><?><?><?><?><?><?>

     stdio=value
                 <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
                 <?><?><?><?><?>/<?><?><?><?><?> (stdin<?> stdout<?> stderr)
                 <?><?><?> <?><?> <?><?><?><?><?>

     stdio=!cmd  <?><?><?><?><?> <?><?><?><?><?>/<?><?><?><?><?> <?><?>
                 <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?> <?><?><?><?><?><?><?><?>

     stdin       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> stdin<?> stdout
                 <?> stderr <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>

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

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

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

     timeout     <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> (timeout)

     timeoutsig  <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
                 <?><?><?><?> <?><?><?><?><?> (timeout) <?><?><?><?>
                 <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
                 <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>

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

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

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

     text        <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> (escape)<?>
                 <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
                 <?><?><?><?><?><?><?><?><?><?>

     'string'    <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> (escape)<?>
                 <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
                 <?><?><?><?><?><?><?><?><?><?>

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

     :102030     <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
                 (hexpair) <?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>

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

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

<?><?><?><?><?><?><?> (EXAMPLES)
     <?><?><?><?><?> <?><?><?><?><?><?><?> rz-run

       $ cat foo.rrz
       #!/usr/bin/rz-run
       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.rrz

     <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>

     nc -l 9999

     rz-run 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 rizin
       $ rizin -r foo.rrz -d ls
       $ cat foo.rrz
       #!/usr/bin/rz-run
       stdio=/dev/ttys010
       ## Or you can use -R to set a key=value
       rizin -R stdio=/dev/ttys010 -d ls

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

     rz-run timeout=2 -- sleep 4

     <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>

     rz-run runlib=/lib/libc-2.25.so runlib.fcn=system arg1="ls /"

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
     rizin(1), rz-hash(1), rz-find(1), rz-bin(1), rz-diff(1), rz-gg(1),
     rz-asm(1),

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

     byteninjaa0

                               January 24, 2024