.\" Man page generated from reStructuredText.
.
.TH "TRACER" "8" "Apr 06, 2024" "recent" "Tracer"
.SH NAME
tracer \- finds outdated running applications in your system
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH DESCRIPTION
.sp
Tracer determines which applications use outdated files and prints them. For special kind of applications such as services or daemons, it suggests a standard command to restart it. Detecting whether file is outdated or not is based on a simple idea. If application has loaded in memory any version of a file which is provided by any package updated since system was booted up, tracer consider this application as outdated.
.SH OPTIONS
.SS GENERAL
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
\-\-version             print program version

\-h, \-\-help            show this help message and exit

\-q, \-\-quiet           do not print additional information

\-v, \-\-verbose         print more informations. Use \-v or \-vv
.ft P
.fi
.UNINDENT
.UNINDENT
.SS MODES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
\-\-helpers             not list applications, but list their helpers

\-i, \-\-interactive     run tracer in interactive mode. Print numbered
                      applications and give helpers based on numbers

\-s app_name [app_name ...], \-\-show app_name [app_name ...]
                      show helper for given application

\-a, \-\-all             list even session and unrestartable applications

\-\-daemons\-only, \-\-services\-only
                      list only daemons/services

\-\-hooks\-only          do not print traced applications, only run their hooks

\-t TIMESTAMP, \-\-timestamp TIMESTAMP
                      since when the updates should be

\-n, \-\-now             when there are specified packages, dont look for time
                      of their update. Use "now" instead
.ft P
.fi
.UNINDENT
.UNINDENT
.SS USERS
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
\-u username, \-\-user username

\-r, \-\-root

\-e, \-\-everyone
.ft P
.fi
.UNINDENT
.UNINDENT
.SS DEBUG
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
\-\-show\-resource=<option>
                      options: packages | processes | rules | applications | system
                      dump informations that tracer can use
.ft P
.fi
.UNINDENT
.UNINDENT
.SH EXIT CODES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
Status codes and their meanings:

+\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
| Status code | Meaning                          |
+=============+==================================+
| 1\-99        | Error exit codes                 |
+\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
| 0           | No affected applications         |
+\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
| 101         | Found some affected applications |
+\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
| 102         | Found some affected daemons      |
+\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
| 103         | Session restart needed           |
+\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
| 104         | Reboot needed                    |
+\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
.ft P
.fi
.UNINDENT
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
Show your applications which needs restarting (basic usage)
    tracer

Show informations about application
    tracer \-\-show mysqld

Show even affected files of the application
    tracer \-\-show mysqld \-vv

In interactive mode show all applications modified only through packages changed since timestamp
    tracer \-iat 1414248388.04
.ft P
.fi
.UNINDENT
.UNINDENT
.SH AUTHOR
FrostyX <frostyx@email.cz>
.SH COPYRIGHT
2016, FrostyX
.\" Generated by docutils manpage writer.
.
