sindex(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | SUBCOMMANDS | COMMON OPTIONS | ADD OPTIONS | SEARCH OPTIONS | FORMAT | KIND | MODE | SEE ALSO | HOMEPAGE | MAILING LIST | COLOPHON

sindex(1)                  General Commands Manual                 sindex(1)

NAME         top

       sindex - Semantic Indexer for C

SYNOPSIS         top

       sindex [options]
       sindex [options] add [command options] [--] [compiler options]
       [files...]
       sindex [options] rm [command options] pattern
       sindex [options] search [command options] [pattern]
       sindex [options] search [command options] (-e|-l)
       filename:linenr:column

DESCRIPTION         top

       sindex is the simple to use cscope-like tool based on sparse/dissect.
       Unlike cscope it runs after pre-processor and thus it can't index the
       code filtered out by ifdef's, but otoh it understands how the symbol
       is used and it can track the usage of struct members.

SUBCOMMANDS         top

       add    generates or updates semantic index file.

       rm     removes files from the index by pattern. The pattern is a
              glob(7) wildcard pattern.

       search queries information about symbol by pattern. The pattern is a
              glob(7) wildcard pattern.

COMMON OPTIONS         top

       -D, --database=FILE
              specify database file (default: ./sindex.sqlite).

       -v, --verbose
              show information about what is being done.

       -h, --help
              show this text and exit.

ADD OPTIONS         top

       --include-local-syms
              include into the index local symbols.

SEARCH OPTIONS         top

       -f, --format=STRING
              specify an output format. Default: '(%m) %f\t%l\t%c\t%C\t%s'
              (see FORMAT below).

       -p, --path=PATTERN
              search symbols only in specified directories.

       -m, --mode=MODE
              search only the specified type of access (see MODE below).

       -k, --kind=KIND
              specify a kind of symbol (see KIND below).

       -e, --explain
              Show what happens in the specified file position;

       -l, --location
              Show usage of symbols from a specific file position;

       -v, --verbose
              show information about what is being done;

       -h, --help
              show this text and exit.

FORMAT         top

       %m     access mode in human readable form (see MODE below).

       %f     file name.

       %l     line number.

       %c     column number.

       %C     the name of the function in which the symbol occurs.

       %n     symbol name.

       %s     source code line. Indexer does not save source code lines.
              They are read from the file during the search.

KIND         top

       f      function

       s      strict

       m      struct member

MODE         top

       The MODE is dumped as a 3-letter string. The first letter denotes
       address of part, 2-nd - access by value, 3-rd - access by pointer. A
       special value ´def´ means a symbol definition.

       r      read

       w      write

       m      read and write

SEE ALSO         top

       sparse(1)

HOMEPAGE         top

       http://www.kernel.org/pub/software/devel/sparse/

MAILING LIST         top

       linux-sparse@vger.kernel.org

COLOPHON         top

       This page is part of the sparse (a Semantic Parser for C) project.
       Information about the project can be found at 
       ⟨https://sparse.wiki.kernel.org/⟩.  If you have a bug report for this
       manual page, send it to linux-sparse@vger.kernel.org.  This page was
       obtained from the project's upstream Git repository
       ⟨https://git.kernel.org/pub/scm/devel/sparse/sparse.git⟩ on
       2020-07-14.  (At that time, the date of the most recent commit that
       was found in the repository was 2020-07-13.)  If you discover any
       rendering problems in this HTML version of the page, or you believe
       there is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

                                                                   sindex(1)