X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=hardware.rst;h=9d157807c03a6ec7d7cdd56600b1085cbd5e894a;hb=676ec4664fd638785c3ad89a88b7a758575e0bc8;hp=8a2bb06f0e801e75a04643fe646f198fc0085641;hpb=05310f9b601c539536b1b86c655bde21fa2a5cf9;p=nageru-docs

diff --git a/hardware.rst b/hardware.rst
index 8a2bb06..9d15780 100644
--- a/hardware.rst
+++ b/hardware.rst
@@ -122,3 +122,20 @@ account for clock and jitter).
 Nageru works in 16-bit floating-point RGBA internally. High-quality conversion to and
 from subsampled Y'CbCr (typically 4:2:2 for inputs and 4:2:0 for outputs)
 is done transparently on the GPU.
+
+
+Performance tips
+----------------
+
+It is strongly recommended to have the rights to run at real-time priority;
+it will make the USB3 threads do so, which will make them a lot more stable.
+(A reasonable hack for testing is probably just to run it as root using sudo,
+although you might not want to do that in production, but instead grant
+your regular user permissions in /etc/security/limits.conf.) Note also that if you
+are running a desktop compositor, it will steal significant amounts of GPU
+performance. The same goes for PulseAudio.
+
+Nageru tries to lock itself into RAM if it has the permissions to do
+so, for better realtime behavior. (Writing the stream to disk tends to
+fill the buffer cache, eventually paging less-used parts of Nageru out.)
+Again, this is something you can set in limits.conf.