vlmcsd.ini.5.html 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744
  1. <!-- Creator : groff version 1.22.3 -->
  2. <!-- CreationDate: Sat Jun 17 00:53:29 2017 -->
  3. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
  4. "http://www.w3.org/TR/html4/loose.dtd">
  5. <html>
  6. <head>
  7. <meta name="generator" content="groff -Thtml, see www.gnu.org">
  8. <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
  9. <meta name="Content-Style" content="text/css">
  10. <style type="text/css">
  11. p { margin-top: 0; margin-bottom: 0; vertical-align: top }
  12. pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
  13. table { margin-top: 0; margin-bottom: 0; vertical-align: top }
  14. h1 { text-align: center }
  15. </style>
  16. <title>VLMCSD.INI</title>
  17. </head>
  18. <body>
  19. <h1 align="center">VLMCSD.INI</h1>
  20. <a href="#NAME">NAME</a><br>
  21. <a href="#SYNOPSIS">SYNOPSIS</a><br>
  22. <a href="#DESCRIPTION">DESCRIPTION</a><br>
  23. <a href="#SYNTAX">SYNTAX</a><br>
  24. <a href="#KEYWORDS">KEYWORDS</a><br>
  25. <a href="#VALID EPIDS">VALID EPIDS</a><br>
  26. <a href="#FILES">FILES</a><br>
  27. <a href="#AUTHOR">AUTHOR</a><br>
  28. <a href="#CREDITS">CREDITS</a><br>
  29. <a href="#SEE ALSO">SEE ALSO</a><br>
  30. <hr>
  31. <h2>NAME
  32. <a name="NAME"></a>
  33. </h2>
  34. <p style="margin-left:11%; margin-top: 1em"><b>vlmcsd.ini</b>
  35. - vlmcsd KMS emulator configuration file</p>
  36. <h2>SYNOPSIS
  37. <a name="SYNOPSIS"></a>
  38. </h2>
  39. <p style="margin-left:11%; margin-top: 1em"><b>vlmcsd.ini</b></p>
  40. <h2>DESCRIPTION
  41. <a name="DESCRIPTION"></a>
  42. </h2>
  43. <p style="margin-left:11%; margin-top: 1em"><b>vlmcsd.ini</b>
  44. (or simply called the &quot;ini file&quot;) is a
  45. configuration file for <b>vlmcsd</b>(8). By default vlmcsd
  46. does not use a configuration file. It is completely optional
  47. and for advanced users only. You must use the <b>-i</b>
  48. option on the vlmcsd command line to use an ini file. There
  49. is no default name or default location for the ini file.</p>
  50. <p style="margin-left:11%; margin-top: 1em">Everything,
  51. that can be configured in the ini file, may also be
  52. specified on the command line. Any configuration option
  53. specified on the command line takes precedence over the
  54. respective configuration line in the ini file.</p>
  55. <p style="margin-left:11%; margin-top: 1em"><b>Benefits of
  56. a configuration file</b></p>
  57. <p style="margin-left:11%; margin-top: 1em">While you can
  58. use the configuration file to simply modify the default
  59. behavior of vlmcsd, it can also be used to change the
  60. configuration of vlmcsd after you sent a HUP
  61. <b>signal</b>(7). Whenever you send SIGHUP, the
  62. configuration file will be re-read. Any changes you made to
  63. the ini file will be reflected after vlmcsd received the
  64. hangup signal.</p>
  65. <p style="margin-left:11%; margin-top: 1em"><b>Differences
  66. between command line and configuration file</b></p>
  67. <p style="margin-left:11%; margin-top: 1em">If you specify
  68. an illegal option or option argument on the command line,
  69. vlmcsd displays help and exits. If you specify an incorrect
  70. <i>keyword</i> or <i>argument</i> in the ini file, vlmcsd
  71. displays a warning with some information, ignores the
  72. respective line and continues. This is intentional and
  73. prevents vlmcsd from aborting after a SIGHUP if the
  74. configuration was modified incorrectly.</p>
  75. <h2>SYNTAX
  76. <a name="SYNTAX"></a>
  77. </h2>
  78. <p style="margin-left:11%; margin-top: 1em">vlmcsd.ini is a
  79. UTF-8 encoded text file with each line being in the format
  80. <i>keyword</i> = <i>argument</i>. The <i>keyword</i> is not
  81. case-sensitive. The <i>argument</i> is treated literally. It
  82. is neither required nor allowed to enclose the
  83. <i>argument</i> in any form of quote characters except when
  84. quote characters are part of the argument itself. Whitespace
  85. characters are ignored only</p>
  86. <p style="margin-left:11%; margin-top: 1em">- at the
  87. beginning of a line <br>
  88. - between the <i>keyword</i> and &rsquo;=&rsquo; <br>
  89. - between &rsquo;=&rsquo; and the <i>argument</i></p>
  90. <p style="margin-left:11%; margin-top: 1em">Lines, that
  91. start with &rsquo;#&rsquo; or &rsquo;;&rsquo; are treated as
  92. comments. Empty lines are ignored as well. If a
  93. <i>keyword</i> is repeated in another line, vlmcsd will use
  94. the <i>argument</i> of the last occurence of the
  95. <i>keyword</i>. An exception to this is the Listen
  96. <i>keyword</i> which can be specified multiple times and
  97. causes vlmcsd to listen on more than one IP address and/or
  98. port.</p>
  99. <p style="margin-left:11%; margin-top: 1em">Some
  100. <i>argument</i>s are binary arguments that need to be either
  101. TRUE or FALSE. You can use &quot;Yes&quot;, &quot;On&quot;
  102. or &quot;1&quot; as an alias for TRUE and &quot;No&quot;,
  103. &quot;Off&quot; or &quot;0&quot; as an alias for FALSE.
  104. Binary arguments are case-insensitive.</p>
  105. <h2>KEYWORDS
  106. <a name="KEYWORDS"></a>
  107. </h2>
  108. <p style="margin-left:11%; margin-top: 1em">The following
  109. <i>keyword</i>s are defined (not all keywords may be
  110. available depending on the operating system and the options
  111. used when <b>vlmcsd</b>(8) was compiled):</p>
  112. <table width="100%" border="0" rules="none" frame="void"
  113. cellspacing="0" cellpadding="0">
  114. <tr valign="top" align="left">
  115. <td width="11%"></td>
  116. <td width="9%">
  117. <p><b>Listen</b></p></td>
  118. <td width="2%"></td>
  119. <td width="78%">
  120. <p>This defines on what combinations of IP addresses and
  121. ports vlmcsd should listen. <b>Listen</b> can be specified
  122. more than once. The <i>argument</i> has the form
  123. <i>ipaddress</i>[:<i>port</i>]. If you omit the <i>port</i>,
  124. the default port of 1688 is used. If the <i>ipaddress</i>
  125. contains colons and a <i>port</i> is used, you must enclose
  126. the <i>ipaddress</i> in brackets. The default is to listen
  127. to 0.0.0.0:1688 and [::]:1688 which means listen to all IPv4
  128. and all IPv6 addresses. See the <b>-L</b> option in
  129. <b>vlmcsd</b>(8) for more info about the syntax. If you use
  130. <b>-L</b> or <b>-P</b> on the command line, all
  131. <b>Listen</b> keywords in the ini file will be ignored. The
  132. <b>Listen</b> keyword cannot be used if vlmcsd has been
  133. compiled to use Microsoft RPC (Windows and Cygwin only) or
  134. simple sockets.</p></td></tr>
  135. </table>
  136. <p style="margin-left:22%; margin-top: 1em">Examples:</p>
  137. <p style="margin-left:22%; margin-top: 1em">Listen =
  138. 192.168.1.123:1688 <br>
  139. Listen = 0.0.0.0:1234 <br>
  140. Listen = [fe80::1721:12ff:fe81:d36b%eth0]:1688</p>
  141. <table width="100%" border="0" rules="none" frame="void"
  142. cellspacing="0" cellpadding="0">
  143. <tr valign="top" align="left">
  144. <td width="11%"></td>
  145. <td width="6%">
  146. <p style="margin-top: 1em"><b>Port</b></p></td>
  147. <td width="5%"></td>
  148. <td width="78%">
  149. <p style="margin-top: 1em">Can only be used if vlmcsd has
  150. been compiled to use simple sockets or on Windows and Cygwin
  151. if <b>vlmcsd</b>(8) has been compiled to use Microsoft RPC.
  152. Otherwise you must use <b>Listen</b> instead. Causes vlmcsd
  153. to listen on that port instead of 1688.</p></td></tr>
  154. </table>
  155. <p style="margin-left:11%;"><b>FreeBind</b></p>
  156. <p style="margin-left:22%;">Can be TRUE or FALSE. If TRUE,
  157. you can use the <b>Listen</b> keyword with IP addresses that
  158. are currently not defined on your system. <b>vlmcsd</b>(8)
  159. will start listening on these IP addresses as soon as they
  160. become available. This keyword is only available under Linux
  161. and FreeBSD because no other OS currently supports that
  162. feature. FreeBSD supports this only for IPv4 and requires
  163. the PRIV_NETINET_BINDANY privilege which is normally
  164. assigned to proccesses of the root user.</p>
  165. <p style="margin-left:11%;"><b>PublicIPProtectionLevel</b></p>
  166. <p style="margin-left:22%;">Set the level of protection
  167. against KMS activations from public IP addresses.</p>
  168. <p style="margin-left:22%; margin-top: 1em">0 = No
  169. protection (default) <br>
  170. 1&nbsp;=&nbsp;Listen on private IP addresses only (plus
  171. those specified by one or more <b>Listen</b> statements)
  172. <br>
  173. 2&nbsp;=&nbsp;Disconnect clients with public IP addresses
  174. without activating <br>
  175. 3&nbsp;=&nbsp;Combines 1 and 2</p>
  176. <p style="margin-left:22%; margin-top: 1em">For details on
  177. public IP protection levels see <b>vlmcsd</b>(8) command
  178. line option <b>-o</b>.</p>
  179. <table width="100%" border="0" rules="none" frame="void"
  180. cellspacing="0" cellpadding="0">
  181. <tr valign="top" align="left">
  182. <td width="11%"></td>
  183. <td width="4%">
  184. <p><b>VPN</b></p></td>
  185. <td width="7%"></td>
  186. <td width="78%">
  187. <p>Has to be in the form
  188. <i>vpn-adapter-name</i>[=<i>ipv4-address</i>][/<i>cidr-mask</i>][:<i>dhcp-lease-duration</i>].</p> </td></tr>
  189. </table>
  190. <p style="margin-left:22%; margin-top: 1em">Enables a
  191. compatible VPN adapter to create additional local IPv4
  192. addresses (like 127.0.0.1) that appear as remote IPv4
  193. addresses to the system. This allows product activation
  194. using a local instance of vlmcsd. This feature is only
  195. available in Windows and Cygwin builds of vlmcsd since it is
  196. not of any use on other operating systems. Compatible VPN
  197. adapters are Tap-windows version 8.2 or higher (from
  198. OpenVPN) and the TeamViewer VPN adapter. There is a special
  199. <i>vpn-adapter-name</i>. A single period (.) instructs
  200. vlmcsd to use the first available compatible VPN adapter.
  201. The <i>vpn-adapter-name</i> is <b>not</b> case-sensitive. If
  202. the <i>vpn-adapter-name</i> contains spaces (e.g. Ethernet
  203. 3), do <b>not</b> enclose it in quotes.</p>
  204. <p style="margin-left:22%; margin-top: 1em">The default
  205. <i>ipv4-address</i> is 10.10.10.9 and the default
  206. <i>cidr-mask</i> is 30. If you are using the default values,
  207. your VPN adapter uses an IPv4 address of 10.10.10.9 and you
  208. can set your activation client to use the easy to remember
  209. address 10.10.10.10 (e.g. slmgr /skms 10.10.10.10 or cscript
  210. ospp.vbs /sethst:10.10.10.10).</p>
  211. <p style="margin-left:22%; margin-top: 1em">The
  212. <i>dhcp-lease-duration</i> is a number optionally followed
  213. by s, m, h, d or w to indicate seconds, minutes, hours, days
  214. or weeks. The default <i>dhcp-lease-duration</i> is 1d (one
  215. day). It is normally not required to change this value.</p>
  216. <p style="margin-left:22%; margin-top: 1em">It is advised
  217. not to manually configure your OpenVPN TAP or TeamViewer VPN
  218. adapter in &quot;Network Connections&quot;. If you set the
  219. IPv4 configuration manually anyway, the IPv4 address and the
  220. subnet mask must match the <b>VPN=</b> directive. It is safe
  221. leave the IPv4 configuration to automatic (DHCP). vlmcsd
  222. will wait up to four seconds for the DHCP configuration to
  223. complete before binding to and listenin on any
  224. interfaces.</p>
  225. <p style="margin-left:22%; margin-top: 1em">You should be
  226. aware that only one program can use a VPN adapter at a time.
  227. If you use the TeamViewer VPN adapter for example, you will
  228. not be able to use the VPN feature of TeamViewer as long as
  229. vlmcsd is running. The same applies to OpenVPN TAP adapters
  230. that are in use by other programs (for example OpenVPN,
  231. QEMU, Ratiborus VM, aiccu, etc.). The best way to avoid
  232. conflicts is to install Tap-Windows from OpenVPN, cd to
  233. C:\Program Files\TAP-Windows\bin and run addtap.bat to
  234. install an additional TAP adapter. Go to &quot;Network
  235. Connections&quot; and rename the new adapter to
  236. &quot;vlmcsd&quot; and specify <b>VPN=vlmcsd</b> to use
  237. it.</p>
  238. <p style="margin-left:11%;"><b>ExitLevel</b></p>
  239. <p style="margin-left:22%;">Can be either 0 (the default)
  240. or 1. Controls under what circumstances vlmcsd will exit.
  241. Using the default of <b>0</b> vlmcsd stays active as long as
  242. it can perform some useful operations. If vlmcsd is run by
  243. any form of a watchdog, e.g. NT service manager (Windows),
  244. systemd (Linux) or launchd (Mac OS / iOS), it may be
  245. desirable to end vlmcsd and let the watchdog restart it.
  246. This is especially true if some pre-requisites are not yet
  247. met but will be some time later, e.g. network is not yet
  248. fully setup.</p>
  249. <p style="margin-left:22%; margin-top: 1em">By using
  250. <b>ExitLevel = 0</b> vlmcsd will</p>
  251. <p style="margin-left:29%; margin-top: 1em">exit if none of
  252. the listening sockets specified with <b>-L</b> can be used.
  253. It continues if at least one socket can be setup for
  254. listening.</p>
  255. <p style="margin-left:29%; margin-top: 1em">exit any TAP
  256. mirror thread (Windows version only) if there is an error
  257. condition while reading or writing from or to the VPN
  258. adapter but continue to work without utilizing a VPN
  259. adapter.</p>
  260. <p style="margin-left:22%; margin-top: 1em">By using
  261. <b>ExitLevel = 1</b> vlmcsd will</p>
  262. <p style="margin-left:29%; margin-top: 1em">exit if not all
  263. listening sockets specified with <b>-L</b> can be used.</p>
  264. <p style="margin-left:29%; margin-top: 1em">exit completely
  265. if there is a problem with a VPN adapter it is using. This
  266. may happen for instance if the VPN adapter has been disabled
  267. using &quot;Control Panel - Network - Adapter Settings&quot;
  268. while vlmcsd is using it.</p>
  269. <p style="margin-left:22%; margin-top: 1em">Please note
  270. that <b>ExitLevel = 1</b> is kind of a workaround option.
  271. While it may help under some circumstances, it is better to
  272. solve the problem at its origin, e.g. properly implementing
  273. dependencies in your startup script to ensure all network
  274. interfaces and the VPN adapter you will use are completely
  275. setup before you start vlmcsd.</p>
  276. <p style="margin-left:11%;"><b>UseNDR64</b></p>
  277. <p style="margin-left:22%;">Can be TRUE or FALSE. Specifies
  278. whether you want to use the NDR64 transfer syntax. See
  279. options <b>-n0</b> and <b>-n1</b> in <b>vlmcsd</b>(8). The
  280. default is TRUE.</p>
  281. <p style="margin-left:11%;"><b>UseBTFN</b></p>
  282. <p style="margin-left:22%;">Can be TRUE or FALSE. Specifies
  283. whether you want to use bind time feature negotiation in
  284. RPC. See options <b>-b0</b> and <b>-b1</b> in
  285. <b>vlmcsd</b>(8). The default is TRUE.</p>
  286. <p style="margin-left:11%;"><b>RandomizationLevel</b></p>
  287. <p style="margin-left:22%;">The <i>argument</i> must 0, 1
  288. or 2. This specifies the ePID randomization level. See
  289. options <b>-r0</b>, <b>-r1</b> and <b>-r2</b> in
  290. <b>vlmcsd</b>(8). The default randomization level is 1. A
  291. <b>RandomizationLevel</b> of 2 is not recommended and should
  292. be treated as a debugging level.</p>
  293. <table width="100%" border="0" rules="none" frame="void"
  294. cellspacing="0" cellpadding="0">
  295. <tr valign="top" align="left">
  296. <td width="11%"></td>
  297. <td width="6%">
  298. <p><b>LCID</b></p></td>
  299. <td width="5%"></td>
  300. <td width="78%">
  301. <p>Use a specific culture id (LCID) even if the ePID is
  302. randomized. The <i>argument</i> must be a number between 1
  303. and 32767. While any number in that range is valid, you
  304. should use an offcial LCID. A list of assigned LCIDs can be
  305. found at
  306. http://msdn.microsoft.com/en-us/goglobal/bb964664.aspx. On
  307. the command line you control this setting with option
  308. <b>-C</b>.</p> </td></tr>
  309. </table>
  310. <p style="margin-left:11%;"><b>MaxWorkers</b></p>
  311. <p style="margin-left:22%;">The <i>argument</i> specifies
  312. the maximum number of worker processes or threads that will
  313. be used to serve activation requests concurrently. This is
  314. the same as specifying <b>-m</b> on the command line.
  315. Minimum is 1. The maximum is platform specific and is at
  316. least 32767 but is likely to be greater on most systems. The
  317. default is no limit.</p>
  318. <p style="margin-left:11%;"><b>ConnectionTimeout</b></p>
  319. <p style="margin-left:22%;">Used to control when the vlmcsd
  320. disconnects idle TPC connections. The default is 30 seconds.
  321. This is the same setting as <b>-t</b> on the command
  322. line.</p>
  323. <p style="margin-left:11%;"><b>DisconnectClientsImmediately</b></p>
  324. <p style="margin-left:22%;">Set this to TRUE to disconnect
  325. a client after it got an activation response regardless
  326. whether a timeout has occured or not. The default is FALSE.
  327. Setting this to TRUE is non-standard behavior. Use only if
  328. you are experiencing DoS or DDoS attacks. On the command
  329. line you control this behavior with options <b>-d</b> and
  330. <b>-k</b>.</p>
  331. <p style="margin-left:11%;"><b>PidFile</b></p>
  332. <p style="margin-left:22%;">Write a pid file. The
  333. <i>argument</i> is the full pathname of a pid file. The pid
  334. file contains is single line containing the process id of
  335. the vlmcsd process. It can be used to stop (SIGTERM) or
  336. restart (SIGHUP) vlmcsd. This directive can be overriden
  337. using <b>-p</b> on the command line.</p>
  338. <p style="margin-left:11%;"><b>LogFile</b></p>
  339. <p style="margin-left:22%;">Write a log file. The
  340. <i>argument</i> is the full pathname of a log file. On a
  341. unixoid OS and with Cygwin you can use the special filename
  342. &rsquo;syslog&rsquo; to log to the syslog facility. This is
  343. the same as specifying <b>-l</b> on the command line.</p>
  344. <p style="margin-left:11%;"><b>KmsData</b></p>
  345. <p style="margin-left:22%;">Use a KMS data file. The
  346. <i>argument</i> is the full pathname of a KMS data file. By
  347. default vlmcsd only contains the minimum product data that
  348. is required to perform all operations correctly. You may use
  349. a more complete KMS data file that contains all detailed
  350. product names. This is especially useful if you are logging
  351. KMS requests. If you don&rsquo;t log, there is no need to
  352. load an external KMS data file.</p>
  353. <p style="margin-left:22%; margin-top: 1em">You may use
  354. <b>KmsData&nbsp;=&nbsp;-</b> to prevent the default KMS data
  355. file to be loaded.</p>
  356. <p style="margin-left:11%;"><b>LogDateAndTime</b></p>
  357. <p style="margin-left:22%;">Can be TRUE or FALSE. The
  358. default is TRUE. If set to FALSE, logging output does not
  359. include date and time. This is useful if you log to
  360. <b>stdout</b>(3) which is redirected to another logging
  361. mechanism that already includes date and time in its output,
  362. for instance <b>systemd-journald</b>(8). If you log to
  363. <b>syslog</b>(3), <b>LogDateAndTime</b> is ignored and date
  364. and time will never be included in the output sent to
  365. <b>syslog</b>(3). Using the command line you control this
  366. setting with options <b>-T0</b> and <b>-T1</b>.</p>
  367. <p style="margin-left:11%;"><b>LogVerbose</b></p>
  368. <p style="margin-left:22%;">Set this to either TRUE or
  369. FALSE. The default is FALSE. If set to TRUE, more details of
  370. each activation will be logged. You use <b>-v</b> and
  371. <b>-q</b> in the command line to control this setting.
  372. <b>LogVerbose</b> has an effect only if you specify a log
  373. file or redirect logging to <b>stdout</b>(3).</p>
  374. <p style="margin-left:11%;"><b>WhitelistingLevel</b></p>
  375. <p style="margin-left:22%;">Can be 0, 1, 2 or 3. The
  376. default is 0. Sets the whitelisting level to determine which
  377. products vlmcsd activates or refuses.</p>
  378. <p style="margin-left:29%; margin-top: 1em"><b>0</b>:
  379. activate all products with an unknown, retail or
  380. beta/preview KMS ID. <b><br>
  381. 1</b>: activate products with a retail or beta/preview KMS
  382. ID but refuse to activate products with an unknown KMS ID.
  383. <b><br>
  384. 2</b>: activate products with an unknown KMS ID but refuse
  385. products with a retail or beta/preview KMS ID. <b><br>
  386. 3</b>: activate only products with a known volume license
  387. RTM KMS ID and refuse all others.</p>
  388. <table width="100%" border="0" rules="none" frame="void"
  389. cellspacing="0" cellpadding="0">
  390. <tr valign="top" align="left">
  391. <td width="22%"></td>
  392. <td width="78%">
  393. <p>The SKU ID is not checked. Like a genuine KMS server
  394. vlmcsd activates a product that has a random or unknown SKU
  395. ID. If you select <b>1</b> or <b>3</b>, vlmcsd also checks
  396. the Application ID for correctness. If Microsoft introduces
  397. a new KMS ID for a new product, you cannot activate it if
  398. you used <b>1</b> or <b>3</b> until a new version of vlmcsd
  399. is available.</p></td></tr>
  400. </table>
  401. <p style="margin-left:11%;"><b>CheckClientTime</b></p>
  402. <p style="margin-left:22%;">Can be TRUE or FALSE. The
  403. default is FALSE. If you set this to TRUE <b>vlmcsd</b>(8)
  404. checks if the client time differs no more than four hours
  405. from the system time. This is useful to prevent emulator
  406. detection. A client that tries to detect an emulator could
  407. simply send two subsequent request with two time stamps that
  408. differ more than four hours from each other. If both
  409. requests succeed, the server is an emulator. If you set this
  410. to TRUE on a system with no reliable time source,
  411. activations will fail. It is ok to set the correct system
  412. time after you started <b>vlmcsd</b>(8).</p>
  413. <p style="margin-left:11%;"><b>MaintainClients</b></p>
  414. <p style="margin-left:22%;">Can be TRUE or FALSE (the
  415. default). Disables (FALSE) or enables (TRUE) maintaining a
  416. list of client machine IDs (CMIDs). TRUE is useful to
  417. prevent emulator detection. By maintaing a CMID list,
  418. <b>vlmcsd</b>(8) reports current active clients exactly like
  419. a genuine KMS emulator. This includes bug compatibility to
  420. the extent that you can permanently kill a genuine KMS
  421. emulator by sending an &quot;overcharge request&quot; with a
  422. required client count of 376 or more and then request
  423. activation for 671 clients. <b>vlmcsd</b>(8) can be reset
  424. from this condition by restarting it. If FALSE is used,
  425. <b>vlmcsd</b>(8) reports current active clients as good as
  426. possible. If no client sends an &quot;overcharge
  427. request&quot;, it is not possible to detect <b>vlmcsd</b>(8)
  428. as an emulator with
  429. <b>MaintainClients&nbsp;</b>=&nbsp;FALSE. Maintaining
  430. clients requires the allocation of a buffer that is about 50
  431. kB in size. On hardware with few memory resources use it
  432. only if you really need it.</p>
  433. <p style="margin-left:22%; margin-top: 1em">If you start
  434. <b>vlmcsd</b>(8) from an internet superserver, this setting
  435. cannot be used. Since <b>vlmcsd</b>(8) exits after each
  436. activation, it cannot maintain any state in memory.</p>
  437. <p style="margin-left:11%;"><b>StartEmpty</b></p>
  438. <p style="margin-left:22%;">This setting is ignored if you
  439. do not also specify <b>MaintainClients&nbsp;</b>=&nbsp;TRUE.
  440. If you specify FALSE (the default), <b>vlmcsd</b>(8) starts
  441. up as a fully &quot;charged&quot; KMS server. Clients
  442. activate immediately. <b>StartEmpty&nbsp;</b>=&nbsp;TRUE
  443. lets you start up <b>vlmcsd</b>(8) with an empty CMID list.
  444. Activation will start when the required minimum clients (25
  445. for Windows Client OSses, 5 for Windows Server OSses and
  446. Office) have registered with the KMS server. As long as the
  447. minimum client count has not been reached, clients end up in
  448. HRESULT 0xC004F038 &quot;The count reported by your Key
  449. Management Service (KMS) is insufficient. Please contact
  450. your system administrator&quot;. You may use <b>vlmcs</b>(1)
  451. or another KMS client emulator to &quot;charge&quot;
  452. <b>vlmcsd</b>(8). Setting this parameter to TRUE does not
  453. improve emulator detection prevention. It&rsquo;s primary
  454. purpose is to help developers of KMS clients to test
  455. &quot;charging&quot; a KMS server.</p>
  456. <p style="margin-left:11%;"><b>ActivationInterval</b></p>
  457. <p style="margin-left:22%;">This is the same as specifying
  458. <b>-A</b> on the command line. See <b>vlmcsd</b>(8) for
  459. details. The default is 2 hours. Example:
  460. ActivationInterval&nbsp;=&nbsp;1h</p>
  461. <p style="margin-left:11%;"><b>RenewalInterval</b></p>
  462. <p style="margin-left:22%;">This is the same as specifying
  463. <b>-R</b> on the command line. See <b>vlmcsd</b>(8) for
  464. details. The default is 7 days. Example: RenewalInterval =
  465. 3d. Please note that the KMS client decides itself when to
  466. renew activation. Even though vlmcsd sends the renewal
  467. interval you specify, it is no more than some kind of
  468. recommendation to the client. Older KMS clients did follow
  469. the recommendation from a KMS server or emulator. Newer
  470. clients do not.</p>
  471. <table width="100%" border="0" rules="none" frame="void"
  472. cellspacing="0" cellpadding="0">
  473. <tr valign="top" align="left">
  474. <td width="11%"></td>
  475. <td width="7%">
  476. <p><b>User</b></p></td>
  477. <td width="4%"></td>
  478. <td width="78%">
  479. <p>Run vlmcsd as another, preferrably less privileged,
  480. user. The <i>argument</i> can be a user name or a numeric
  481. user id. You must have the required privileges (capabilities
  482. on Linux) to change the security context of a process
  483. without providing any credentials (a password in most
  484. cases). On most unixoid OSses &rsquo;root&rsquo; is the only
  485. user who has these privileges in the default configuration.
  486. This setting is not available in the native Windows version
  487. of vlmcsd. See <b>-u</b> in <b>vlmcsd</b>(8). This setting
  488. cannot be changed on the fly by sending SIGHUP to
  489. vlmcsd.</p> </td></tr>
  490. <tr valign="top" align="left">
  491. <td width="11%"></td>
  492. <td width="7%">
  493. <p><b>Group</b></p></td>
  494. <td width="4%"></td>
  495. <td width="78%">
  496. <p>Run vlmcsd as another, preferrably less privileged,
  497. group. The <i>argument</i> can be a group name or a numeric
  498. group id. You must have the required privileges
  499. (capabilities on Linux) to change the security context of a
  500. process without providing any credentials (a password in
  501. most cases). On most unixoid OSses &rsquo;root&rsquo; is the
  502. only user who has these privileges in the default
  503. configuration. This setting is not available in the native
  504. Windows version of vlmcsd. See <b>-g</b> in
  505. <b>vlmcsd</b>(8). This setting cannot be changed on the fly
  506. by sending SIGHUP to vlmcsd.</p></td></tr>
  507. </table>
  508. <p style="margin-left:11%;"><b>Windows</b></p>
  509. <p style="margin-left:22%;">The <i>argument</i> has the
  510. form <i>ePID</i> [ / <i>HwId</i> ]. Always use <i>ePID</i>
  511. and <i>HwId</i> for Windows activations. If specified,
  512. <b>RandomizationLevel</b> for Windows activitations will be
  513. ignored.</p>
  514. <p style="margin-left:11%;"><b>Office2010</b></p>
  515. <p style="margin-left:22%;">The <i>argument</i> has the
  516. form <i>ePID</i> [ / <i>HwId</i> ]. Always use <i>ePID</i>
  517. and <i>HwId</i> for Office 2010 activations. If specified,
  518. <b>RandomizationLevel</b> for Office 2010 activitations will
  519. be ignored.</p>
  520. <p style="margin-left:11%;"><b>Office2013</b></p>
  521. <p style="margin-left:22%;">The <i>argument</i> has the
  522. form <i>ePID</i> [ / <i>HwId</i> ]. Always use <i>ePID</i>
  523. and <i>HwId</i> for Office 2013 activations. If specified,
  524. <b>RandomizationLevel</b> for Office 2013 activitations will
  525. be ignored.</p>
  526. <p style="margin-left:11%;"><b>Office2016</b></p>
  527. <p style="margin-left:22%;">The <i>argument</i> has the
  528. form <i>ePID</i> [ / <i>HwId</i> ]. Always use <i>ePID</i>
  529. and <i>HwId</i> for Office 2016 activations. If specified,
  530. <b>RandomizationLevel</b> for Office 2016 activitations will
  531. be ignored.</p>
  532. <p style="margin-left:11%;"><b>WinChinaGov</b></p>
  533. <p style="margin-left:22%;">The <i>argument</i> has the
  534. form <i>ePID</i> [ / <i>HwId</i> ]. Always use <i>ePID</i>
  535. and <i>HwId</i> for China Government Editions of Windows
  536. (Enterprise G/GN). If specified, <b>RandomizationLevel</b>
  537. for Windows China Government activitations will be
  538. ignored.</p>
  539. <h2>VALID EPIDS
  540. <a name="VALID EPIDS"></a>
  541. </h2>
  542. <p style="margin-left:11%; margin-top: 1em">The ePID is
  543. currently a comment only. You can specify any string up to
  544. 63 bytes. In Windows 7 Microsoft has blacklisted few ( &lt;
  545. 10 ) ePIDs that were used in KMSv5 versions of the
  546. &quot;Ratiborus Virtual Machine&quot;. Microsoft has given
  547. up on blacklisting when KMS emulators appeared in the
  548. wild.</p>
  549. <p style="margin-left:11%; margin-top: 1em">Even if you can
  550. use &quot;Activated by cool hacker guys&quot; as an ePID,
  551. you may wish to use ePIDs that cannot be detected as non-MS
  552. ePIDs. If you don&rsquo;t know how these &quot;valid&quot;
  553. ePIDs look like exactly, do not use GUIDS in vlmcsd.ini.
  554. vlmcsd provides internal mechanisms to generate valid
  555. ePIDs.</p>
  556. <p style="margin-left:11%; margin-top: 1em">If you use
  557. non-ASCII characters in your ePID (you shouldn&rsquo;t do
  558. anyway), these must be in UTF-8 format. This is especially
  559. important when you run vlmcsd on Windows or cygwin because
  560. UTF-8 is not the default encoding for most editors.</p>
  561. <p style="margin-left:11%; margin-top: 1em">If you are
  562. specifying an optional HWID it follows the same syntax as in
  563. the <b>-H</b> option in <b>vlmcsd</b>(8) ecxept that you
  564. must not enclose a HWID in quotes even if it contains
  565. spaces.</p>
  566. <h2>FILES
  567. <a name="FILES"></a>
  568. </h2>
  569. <p style="margin-left:11%; margin-top: 1em"><b>vlmcsd.ini</b>(5)</p>
  570. <h2>AUTHOR
  571. <a name="AUTHOR"></a>
  572. </h2>
  573. <p style="margin-left:11%; margin-top: 1em"><b>vlmcsd</b>(8)
  574. was written by crony12, Hotbird64 and vityan666. With
  575. contributions from DougQaid.</p>
  576. <h2>CREDITS
  577. <a name="CREDITS"></a>
  578. </h2>
  579. <p style="margin-left:11%; margin-top: 1em">Thanks to
  580. CODYQX4, deagles, eIcn, mikmik38, nosferati87, qad,
  581. Ratiborus, ...</p>
  582. <h2>SEE ALSO
  583. <a name="SEE ALSO"></a>
  584. </h2>
  585. <p style="margin-left:11%; margin-top: 1em"><b>vlmcsd</b>(8),
  586. <b>vlmcsd</b>(7), <b>vlmcs</b>(1), <b>vlmcsdmulti</b>(1)</p>
  587. <hr>
  588. </body>
  589. </html>