doc/niceness.texi

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