7.4 The run-on-binaries-in script ¶

run-on-binaries-in
  [--help]
  [--version]
  [--verbose]
  [--quiet]
  [--ignore]
  [--prefix=‘text’]
  [--tmpdir=dir]
  [--files-from=file]
  [--skip-list=file]
  [--]
  program
  [program-options]
  file...

The run-on-binaries-in script allows other scripts, or programs, to be run on the executable files contained inside archives. This includes ‘rpm’ files, ‘tar’ and ‘ar’ files and compressed files.

The script does not recurse into directories, but this can be handled by the find command, like this:

  find . -type f -exec run-on-binaries-in <script-to-run> {} \;

The script accepts the following command line options:

--help

-h

Displays the usage of the script and then exits.

--version

-v

Displays the version of the script.

--verbose

-V

Enables verbose mode, causing the script to detail each action it takes.

If this option is repeated it has the special effect of canceling out the automatic addition of the -i to recursive invocations of the script.

--quiet

-q

Do not include the name of script in the out generated by the script.

--ignore

-i

Do not report file types that are not supported or recognised.

This option is automatically enabled when the script is recursively invoked on an archive, unless the -V -V has been enabled. This is because it is assumed that archives are likely to contain files that do not need to be scanned.

--prefix=‘text’

-p ‘text’

Add this text to the output from the script when it runs the program on a normal executable.

--tmpdir=dir

-t dir

Directory to use to store temporary files.

--files-from=file

-f=file

Specifies a file containing a list of other files to examine, one per line.

--skip-list=file

-s=file

Specifies a file containing a list of files not to examine, one per line. Blank lines and comments are ignored. Text after a file’s name is also ignored. Filenames should start at the beginning of a line.

--

Stops processing of command line options. This allows the script to be run with a program whose name starts with a dash.