Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

llvm-extract (1)

Name

llvm-extract - extract a function from an LLVM module

Synopsis

llvm-extract [options] --func function-name [filename]

Description

LLVM-EXTRACT(1)                      LLVM                      LLVM-EXTRACT(1)



NAME
       llvm-extract - extract a function from an LLVM module

SYNOPSIS
       llvm-extract [options] --func function-name [filename]

DESCRIPTION
       The  llvm-extract  command takes the name of a function and extracts it
       from the specified LLVM bitcode file.  It is primarily used as a debug-
       ging tool to reduce test cases from larger programs that are triggering
       a bug.

       In addition to  extracting  the  bitcode  of  the  specified  function,
       llvm-extract will also remove unreachable global variables, prototypes,
       and unused types.

       The llvm-extract command reads its input from standard input  if  file-
       name  is  omitted or if filename is -.  The output is always written to
       standard output, unless the -o option is specified (see below).

OPTIONS
       -f
          Enable binary output  on  terminals.   Normally,  llvm-extract  will
          refuse  to write raw bitcode output if the output stream is a termi-
          nal.  With this option, llvm-extract will write raw bitcode  regard-
          less of the output device.

       --func function-name
          Extract the function named function-name from the LLVM bitcode.  May
          be specified multiple times to extract multiple functions at once.

       --rfunc function-regular-expr
          Extract the function(s) matching function-regular-expr from the LLVM
          bitcode.   All  functions  matching  the  regular expression will be
          extracted.  May be specified multiple times.

       --glob global-name
          Extract the global variable named global-name from the LLVM bitcode.
          May be specified multiple times to extract multiple global variables
          at once.

       --rglob glob-regular-expr
          Extract the global variable(s) matching global-regular-expr from the
          LLVM  bitcode.  All global variables matching the regular expression
          will be extracted.  May be specified multiple times.

       -help
          Print a summary of command line options.

       -o filename
          Specify the output filename.  If filename is "-" (the default), then
          llvm-extract sends its output to standard output.

       -S
          Write output in LLVM intermediate language (instead of bitcode).

EXIT STATUS
       If  llvm-extract succeeds, it will exit with 0.  Otherwise, if an error
       occurs, it will exit with a non-zero value.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+---------------------+
       |ATTRIBUTE TYPE |  ATTRIBUTE VALUE    |
       +---------------+---------------------+
       |Availability   | developer/llvm/llvm |
       +---------------+---------------------+
       |Stability      | Uncommitted         |
       +---------------+---------------------+
SEE ALSO
       bugpoint

AUTHOR
       Maintained by The LLVM Team (http://llvm.org/).

COPYRIGHT
       2003-2016, LLVM Project



NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source                was                downloaded                from
       https://llvm.org//releases/6.0.1/llvm-6.0.1.src.tar.xz

       Further information about this software can be found on the open source
       community website at https://llvm.org/.



3.8                               2016-07-10                   LLVM-EXTRACT(1)