Skip to content

S
Software for White Rabbit PTP Core
Commit e4fa232e authored by Adam Wujek's avatar Adam Wujek 💬 Committed by Grzegorz Daniluk
Browse files
Options

doc: update documentation with "ps max" command 

Signed-off-by: Adam Wujek's avatarAdam Wujek <adam.wujek@cern.ch>
parent eba3d116
Hide whitespace changes
Inline Side-by-side
Showing with 44 additions and 16 deletions
doc/wrpc.tex
View file @ e4fa232e
...@@ -1523,25 +1523,47 @@ The node now has a \textit{ps} command, that shows the number of iterations ...@@ -1523,25 +1523,47 @@ The node now has a \textit{ps} command, that shows the number of iterations
and time spent in each \textit{task}. Each task reports when it did and time spent in each \textit{task}. Each task reports when it did
something (as opposed to just polling the clock or network socket and something (as opposed to just polling the clock or network socket and
seeing that nothing is there to do); the \textit{iterations} count shows how many seeing that nothing is there to do); the \textit{iterations} count shows how many
times the task did something. times the task did something. The \textit{max\_ms} show the longest execution
time of a particular task.
\begin{lstlisting}
wrc# ps \begin{lstlisting}
iterations seconds.micros name wrc# ps
44288501 4242.816329 idle iterations seconds.micros max_ms name
0 0.000000 spll-bh 145560 29.007144 75 idle
37 0.016549 shell+gui 0 0.000000 0 spll-bh
8992 1.158969 ptp 6 0.001630 1 shell+gui
4252 0.037005 uptime 642 2.540416 8 ptp
1 0.001035 check-link 31 0.000361 1 uptime
0 0.000000 stats 1 0.050424 51 check-link
0 0.000000 net-bh 32 0.011172 9 diags
568 5.068343 temperature 0 0.000000 0 stats
235 0.023562 1 net-bh
32 0.029157 2 ipv4
0 0.000000 0 arp
0 0.000000 0 snmp
6 0.054566 12 temperature
\end{lstlisting} \end{lstlisting}
By using ``\texttt{ps reset}'' you can zero all counters to start a new By using ``\texttt{ps reset}'' you can zero all counters to start a new
test run. test run.
It is possible to configure \texttt{ps} in such way that it prints information
when any task runs longer than any run before since reset
(or \texttt{ps reset}) and when it runs longer than a specified value
in miliseconds.
For this please use command ``\texttt{ps max <msecs>}'', where
\texttt{<msecs>} is a number of miliseconds triggering printouts.
\begin{lstlisting}
wrc# ps max 10
task temperature, run for 11 ms
task temperature, run for 12 ms
task temperature, run for 11 ms
wrc# ps
[...]
New max run time for a task shell+gui, old 1, new 75
task shell+gui, run for 75 ms
\end{lstlisting}
% -------------------------------------------------------------------------- % --------------------------------------------------------------------------
\subsubsection{Pfilter rules} \subsubsection{Pfilter rules}
\label{Pfilter rules} \label{Pfilter rules}
...@@ -1813,12 +1835,18 @@ tools used to build and run it, you can write to our mailing list ...@@ -1813,12 +1835,18 @@ tools used to build and run it, you can write to our mailing list
\code{pll stop <channel>} & stops SoftPLL for the channel \\ \code{pll stop <channel>} & stops SoftPLL for the channel \\
\code{ps} & prints the list of running tasks (processes) in the CPU. For \code{ps} & prints the list of running tasks (processes) in the CPU. For
each task you get the number of iterations and the CPU time consumed since each task you get the number of iterations, the maximum execution time
boot or last reset of values \\ (measured with the monotonic clock) and the CPU time consumed (using
the RT clock) since boot or last reset of values \\
\code{ps reset} & zeroes the profiling information reported by the \code{ps} \code{ps reset} & zeroes the profiling information reported by the \code{ps}
command \\ command \\
\code{ps max <msecs>} & starts printing all tasks executing longer than
a given number of miliseconds. Additionally, it triggers printing messages
if particular task runs longer than ever before. Passing ``\code{0}'' as
a parameter stops the further printouts. \\
\code{ptp <e2e|p2p>} & selects PTP delay mechanism: end-to-end or peer-to-peer. \code{ptp <e2e|p2p>} & selects PTP delay mechanism: end-to-end or peer-to-peer.
If configured, you can set \texttt{p2p} mode. Alternatively you can use also If configured, you can set \texttt{p2p} mode. Alternatively you can use also
aliases: \texttt{delay} (instead of \texttt{e2e}) or \texttt{pdelay} aliases: \texttt{delay} (instead of \texttt{e2e}) or \texttt{pdelay}
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment