doc/niceness.texi

   1 @node Niceness
   2 @unnumbered Niceness
   3
   4 Each transmitted packet has niceness level, as Unix has @command{nice}
   5 command for controlling processes priority. Higher nicer level means
   6 that packet is "nicer" and allows other to bypass him -- that means
   7 lower transmission precedence.
   8
   9 Send big files with higher nice level! That will guarantee you that
  10 higher priority packets, like mail messages, will pass first, even when
  11 lower priority packet was already been partially downloaded.
  12
  13 There are default niceness levels built-in for @ref{nncp-exec},
  14 @ref{nncp-file} and @ref{nncp-freq} commands. But pay attention that it
  15 can give information about underlying payload to the adversary!
  16
  17 There are 1-255 niceness levels. They could be specified either as
  18 integer, or using aliases with delta modifiers:
  19
  20 @table @emph
  21 @item FLASH (F)
  22 Urgent priority.
  23 @item PRIORITY (P)
  24 High priority. Command execution/mail use that priority by default.
  25 @item NORMAL (N)
  26 Normal priority. File requests use that priority by default.
  27 @item BULK (B)
  28 Bundles shipped on a "least effort" basis. File transmission use that
  29 priority by default.
  30 @end table
  31
  32 @verbatim
  33  1: F-31   65: P-31  129: N-31  193: B-31
  34  2: F-30   66: P-30  130: N-30  194: B-30
  35     ...        ...        ...        ...
  36 32: F      96: P     160: N     224: B
  37 33: F+1    97: P+1   161: N+1   225: B+1
  38 34: F+2    98: P+2   162: N+2   226: B+2
  39     ...        ...        ...        ...
  40 64: F+32  128: P+32  192: N+32  255: B+31 | MAX
  41 @end verbatim
  42
  43 Precedence could be specified both with single-letter aliases and with
  44 whole strings. They are case insensitive. @emph{MAX} is an alias for 255
  45 niceness level.