.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.13.
.TH RTAGS-RDM "7" "December 2020" "rdm 2.41.133" "User Commands"
.SH NAME
rtags-rdm \- manual page for RTags server
.SH SYNOPSIS
rtags-rdm [OPTION]...
.SH DESCRIPTION
RTags is a client/server application that indexes C/C++ code and keeps
a persistent file\-based database of references, declarations,
definitions, symbolnames etc. There's also limited support for
ObjC/ObjC++. It allows you to find symbols by name (including nested
class and namespace scope). Most importantly we give you proper
follow\-symbol and find\-references support. We also have neat little
things like rename\-symbol, integration with clang's "fixits"
(http://clang.llvm.org/diagnostics.html). We also integrate with
flymake using clang's vastly superior errors and warnings. Since
RTags constantly will reindex "dirty" files you get live updates of
compiler errors and warnings. Since we already know how to compile
your sources we have a way to quickly bring up the preprocessed output
of the current source file in a buffer.

While existing taggers like gnu global, cscope, etags, ctags etc do a
decent job for C they often fall a little bit short for C++. With its
incredible lexical complexity, parsing C++ is an incredibly hard task
and we make no bones about the fact that the only reason we are able
to improve on the current tools is because of clang
(http://clang.llvm.org/). RTags is named RTags in recognition of
Roberto Raggi on whose C++ parser we intended to base this project but
he assured us clang was the way to go. The name stuck though.
.PP
.SH OPTIONS
.TP
\fB\-\-help\fR|\-h
Display this page.
.TP
\fB\-\-version\fR
Display version.
.TP
\fB\-\-include\-path\fR|\-I [arg]
Add additional include path to clang.
.TP
\fB\-\-no\-libclang\-include\-path\fR
Don't use the include path from libclang.
.TP
\fB\-\-isystem\fR|\-s [arg]
Add additional system include path to clang.
.TP
\fB\-\-define\fR|\-D [arg]
Add additional define directive to clang.
.TP
\fB\-\-default\-argument\fR [arg]
Add additional argument to clang.
.TP
\fB\-\-log\-file\fR|\-L [arg]
Log to this file.
.TP
\fB\-\-crash\-dump\-file\fR [arg]
File to dump crash log to (default is <datadir>/crash.dump).
.TP
\fB\-\-setenv\fR|\-e [arg]
Set this environment variable (\fB\-\-setenv\fR "foobar=1").
.TP
\fB\-\-no\-Wall\fR|\-W
Don't use \fB\-Wall\fR.
.TP
\fB\-\-Weverything\fR|\-u
Use \fB\-Weverything\fR.
.TP
\fB\-\-verbose\fR|\-v
Change verbosity, multiple \fB\-v\fR's are allowed.
.TP
\fB\-\-job\-count\fR|\-j [arg]
Spawn this many concurrent processes for indexing (default to the number of available processing units or 2 otherwise).
.TP
\fB\-\-test\fR|\-t [arg]
Run this test.
.TP
\fB\-\-tempdir\fR [arg]
Use this directory for temporary files. Clang generates a lot of these and rtags will periodically clean out this directory (default is $TMPDIR/rtags/)
.TP
\fB\-\-test\-timeout\fR|\-z [arg]
Timeout for test to complete.
.TP
\fB\-\-clean\-slate\fR|\-C
Clear out all data.
.TP
\fB\-\-disable\-sighandler\fR|\-x
Disable signal handler to dump stack for crashes.
.TP
\fB\-\-silent\fR|\-S
No logging to stdout/stderr.
.TP
\fB\-\-exclude\-filter\fR|\-X [arg]
Files to exclude from rtags-rdm (default "*/CMakeFiles/*;*/cmake*/Modules/*;*/conftest.c*;/tmp/*;/private/tmp/*;/private/var/*".)
.TP
\fB\-\-socket\-file\fR|\-n [arg]
Use this file for the server socket (default is XDG_RUNTIME_DIR/rdm.socket else ~/.rdm).
.TP
\fB\-\-data\-dir\fR|\-d [arg]
Use this directory to store persistent data (default \fI\,$XDG_CACHE_HOME/rtags\/\fP otherwise ~/.cache/rtags).
.TP
\fB\-\-ignore\-printf\-fixits\fR|\-F
Disregard any clang fixit that looks like it's trying to fix format for printf and friends.
.TP
\fB\-\-error\-limit\fR|\-f [arg]
Set error limit to argument (\fB\-ferror\-limit=\fR{arg} (default 50).
.TP
\fB\-\-block\-argument\fR|\-G [arg]
Block this argument from being passed to clang. E.g. rtags-rdm \fB\-\-block\-argument\fR \fB\-fno\-inline\fR
.TP
\fB\-\-no\-spell\-checking\fR|\-l
Don't pass \fB\-fspell\-checking\fR.
.TP
\fB\-\-large\-by\-value\-copy\fR|\-r [arg]
Use \fB\-Wlarge\-by\-value\-copy\fR=\fI\,[arg]\/\fR when invoking clang.
.TP
\fB\-\-allow\-multiple\-sources\fR|\-m
Don't merge source files added with \fB\-c\fR.
.TP
\fB\-\-no\-startup\-project\fR|\-o
Don't restore the last current project on startup.
.TP
\fB\-\-no\-no\-unknown\-warnings\-option\fR|\-Y
Don't pass \fB\-Wno\-unknown\-warning\-option\fR.
.TP
\fB\-\-ignore\-compiler\fR|\-b [arg]
Ignore this compiler.
.TP
\fB\-\-compiler\-wrappers\fR [arg]
Consider these filenames compiler wrappers (split on ;), default "ccache".
.TP
\fB\-\-watch\-system\-paths\fR|\-w
Watch system paths for changes.
.TP
\fB\-\-rp\-visit\-file\-timeout\fR|\-Z [arg]
Timeout for rp visitfile commands in ms (0 means no timeout) (default 60000).
.TP
\fB\-\-rp\-indexer\-message\-timeout\fR|\-T [arg]
Timeout for rp indexer\-message in ms (0 means no timeout) (default 60000).
.TP
\fB\-\-rp\-connect\-timeout\fR|\-O [arg]
Timeout for connection from rp to rtags-rdm in ms (0 means no timeout) (default 0).
.TP
\fB\-\-rp\-connect\-attempts\fR [arg]
Number of times rp attempts to connect to rtags-rdm before giving up. (default 3).
.TP
\fB\-\-rp\-nice\-value\fR|\-a [arg]
Nice value to use for rp (nice(2)) (default is no nicing).
.TP
\fB\-\-suspend\-rp\-on\-crash\fR|\-q
Suspend rp in SIGSEGV handler (default off).
.TP
\fB\-\-rp\-log\-to\-syslog\fR
Make rp log to syslog.
.TP
\fB\-\-start\-suspended\fR|\-Q
Start out suspended (no reindexing enabled).
.TP
\fB\-\-separate\-debug\-and\-release\fR|\-E
Normally rtags-rdm doesn't consider release and debug as different builds. Pass this if you want it to.
.TP
\fB\-\-separate\-32\-bit\-and\-64\-bit\fR
Normally rtags-rdm doesn't consider \fB\-m32\fR and \fB\-m64\fR as different builds. Pass this if you want it to.
.HP
\fB\-\-ignore\-include\-path\-differences\-in\-usr\fR Don't consider sources that only differ in includepaths within \fI\,/usr\/\fP (not including /usr/home/) as different builds.
.TP
\fB\-\-max\-crash\-count\fR|\-K [arg]
Max number of crashes before giving up a sourcefile (default 5).
.TP
\fB\-\-max\-socket\-write\-buffer\-size\fR [arg]
Max number of bytes buffered after EAGAIN.
.TP
\fB\-\-completion\-cache\-size\fR|\-i [arg]
Number of translation units to cache (default 10).
.TP
\fB\-\-completion\-no\-filter\fR
Don't filter private members and destructors from completions.
.TP
\fB\-\-completion\-logs\fR
Log more info about completions.
.TP
\fB\-\-completion\-diagnostics\fR [optional]
Send diagnostics from completion thread.
.TP
\fB\-\-rp\-daemon\fR [arg]
Keep this many rp daemons alive and cache the last tu. Default to 1
.TP
\fB\-\-max\-include\-completion\-depth\fR [arg]
Max recursion depth for header completion (default 3).
.TP
\fB\-\-allow\-Wpedantic\fR|\-P
Don't strip out \fB\-Wpedantic\fR. This can cause problems in certain projects.
.TP
\fB\-\-allow\-Werror\fR
Don't strip out \fB\-Werror\fR and \fB\-Wfatal\-errors\fR. By default these are stripped out.
.TP
\fB\-\-enable\-compiler\-manager\fR|\-R
Query compilers for their actual include paths instead of letting clang use its own. This is now the default. Kept for backwards compatibility.
.TP
\fB\-\-disable\-compiler\-manager\fR
Do not query compilers for their actual include paths instead of letting clang use its own.
.TP
\fB\-\-enable\-NDEBUG\fR|\-g
Don't remove \fB\-DNDEBUG\fR from compile lines.
.TP
\fB\-\-progress\fR|\-p
Report compilation progress in diagnostics output.
.TP
\fB\-\-max\-file\-map\-cache\-size\fR|\-y [arg]
Max files to cache per query (Should not exceed maximum number of open file descriptors allowed per process) (default 500).
.TP
\fB\-\-no\-filemanager\-watch\fR|\-M
Don't use a file system watcher for filemanager.
.TP
\fB\-\-no\-filemanager\fR
Don't scan project directory for files. (rtags-rc \fB\-P\fR won't work).
.TP
\fB\-\-no\-file\-lock\fR
Disable file locking. Not entirely safe but might improve performance on certain systems.
.TP
\fB\-\-pch\-enabled\fR
Enable PCH (experimental).
.TP
\fB\-\-no\-filesystem\-watcher\fR|\-B
Disable file system watching altogether. Reindexing has to be triggered manually.
.TP
\fB\-\-arg\-transform\fR|\-V [arg]
Use arg to transform arguments. [arg] should be executable with (execv(3)).
.TP
\fB\-\-no\-comments\fR
Don't parse/store doxygen comments.
.TP
\fB\-\-inactivity\-timeout\fR [arg]
Time in seconds after which rtags-rdm will quit if there's been no activity (N.B., once rtags-rdm has quit, something will need to re\-run it!).
.TP
\fB\-\-daemon\fR
Run as daemon (detach from terminal).
.TP
\fB\-\-log\-file\-log\-level\fR [arg]
Log level for log file (default is error), options are: error, warning, debug or verbose\-debug.
.TP
\fB\-\-watch\-sources\-only\fR
Only watch source files (not dependencies).
.TP
\fB\-\-debug\-locations\fR [arg]
Set debug locations.
.TP
\fB\-\-validate\-file\-maps\fR
Spend some time validating project data on startup.
.TP
\fB\-\-tcp\-port\fR [arg]
Listen on this tcp socket (default none).
.TP
\fB\-\-rp\-path\fR [arg]
Path to rp (default \fI\,/usr/lib/rtags/rp\/\fP).
.TP
\fB\-\-log\-timestamp\fR
Add timestamp to logs.
.TP
\fB\-\-log\-flush\fR
Flush stderr/stdout after each log.
.TP
\fB\-\-sandbox\-root\fR [arg]
Create index using relative paths by stripping dir (enables copying of tag index db files without need to reindex).
.TP
\fB\-\-poll\-timer\fR [arg]
Poll the database of the current project every <arg> seconds.
.TP
\fB\-\-no\-realpath\fR
Don't use realpath(3) for files
.TP
\fB\-\-config\fR|\-c [arg]
Use this file (instead of ~/.rdmrc).
.TP
\fB\-\-no\-rc\fR|\-N
Don't load any rc files.
.SH "SEE ALSO"
rtags-rc(7)