vlmcsd.ini.5.html 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688
  1. <!-- Creator : groff version 1.22.3 -->
  2. <!-- CreationDate: Sun Dec 11 22:03:20 2016 -->
  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>UseNDR64</b></p>
  239. <p style="margin-left:22%;">Can be TRUE or FALSE. Specifies
  240. whether you want to use the NDR64 transfer syntax. See
  241. options <b>-n0</b> and <b>-n1</b> in <b>vlmcsd</b>(8). The
  242. default is TRUE.</p>
  243. <p style="margin-left:11%;"><b>UseBTFN</b></p>
  244. <p style="margin-left:22%;">Can be TRUE or FALSE. Specifies
  245. whether you want to use bind time feature negotiation in
  246. RPC. See options <b>-b0</b> and <b>-b1</b> in
  247. <b>vlmcsd</b>(8). The default is TRUE.</p>
  248. <p style="margin-left:11%;"><b>RandomizationLevel</b></p>
  249. <p style="margin-left:22%;">The <i>argument</i> must 0, 1
  250. or 2. This specifies the ePID randomization level. See
  251. options <b>-r0</b>, <b>-r1</b> and <b>-r2</b> in
  252. <b>vlmcsd</b>(8). The default randomization level is 1. A
  253. <b>RandomizationLevel</b> of 2 is not recommended and should
  254. be treated as a debugging level.</p>
  255. <table width="100%" border="0" rules="none" frame="void"
  256. cellspacing="0" cellpadding="0">
  257. <tr valign="top" align="left">
  258. <td width="11%"></td>
  259. <td width="6%">
  260. <p><b>LCID</b></p></td>
  261. <td width="5%"></td>
  262. <td width="78%">
  263. <p>Use a specific culture id (LCID) even if the ePID is
  264. randomized. The <i>argument</i> must be a number between 1
  265. and 32767. While any number in that range is valid, you
  266. should use an offcial LCID. A list of assigned LCIDs can be
  267. found at
  268. http://msdn.microsoft.com/en-us/goglobal/bb964664.aspx. On
  269. the command line you control this setting with option
  270. <b>-C</b>.</p> </td></tr>
  271. </table>
  272. <p style="margin-left:11%;"><b>MaxWorkers</b></p>
  273. <p style="margin-left:22%;">The <i>argument</i> specifies
  274. the maximum number of worker processes or threads that will
  275. be used to serve activation requests concurrently. This is
  276. the same as specifying <b>-m</b> on the command line.
  277. Minimum is 1. The maximum is platform specific and is at
  278. least 32767 but is likely to be greater on most systems. The
  279. default is no limit.</p>
  280. <p style="margin-left:11%;"><b>ConnectionTimeout</b></p>
  281. <p style="margin-left:22%;">Used to control when the vlmcsd
  282. disconnects idle TPC connections. The default is 30 seconds.
  283. This is the same setting as <b>-t</b> on the command
  284. line.</p>
  285. <p style="margin-left:11%;"><b>DisconnectClientsImmediately</b></p>
  286. <p style="margin-left:22%;">Set this to TRUE to disconnect
  287. a client after it got an activation response regardless
  288. whether a timeout has occured or not. The default is FALSE.
  289. Setting this to TRUE is non-standard behavior. Use only if
  290. you are experiencing DoS or DDoS attacks. On the command
  291. line you control this behavior with options <b>-d</b> and
  292. <b>-k</b>.</p>
  293. <p style="margin-left:11%;"><b>PidFile</b></p>
  294. <p style="margin-left:22%;">Write a pid file. The
  295. <i>argument</i> is the full pathname of a pid file. The pid
  296. file contains is single line containing the process id of
  297. the vlmcsd process. It can be used to stop (SIGTERM) or
  298. restart (SIGHUP) vlmcsd. This directive can be overriden
  299. using <b>-p</b> on the command line.</p>
  300. <p style="margin-left:11%;"><b>LogFile</b></p>
  301. <p style="margin-left:22%;">Write a log file. The
  302. <i>argument</i> is the full pathname of a log file. On a
  303. unixoid OS and with Cygwin you can use the special filename
  304. &rsquo;syslog&rsquo; to log to the syslog facility. This is
  305. the same as specifying <b>-l</b> on the command line.</p>
  306. <p style="margin-left:11%;"><b>KmsData</b></p>
  307. <p style="margin-left:22%;">Use a KMS data file. The
  308. <i>argument</i> is the full pathname of a KMS data file. By
  309. default vlmcsd only contains the minimum product data that
  310. is required to perform all operations correctly. You may use
  311. a more complete KMS data file that contains all detailed
  312. product names. This is especially useful if you are logging
  313. KMS requests. If you don&rsquo;t log, there is no need to
  314. load an external KMS data file.</p>
  315. <p style="margin-left:22%; margin-top: 1em">You may use
  316. <b>KmsData&nbsp;=&nbsp;-</b> to prevent the default KMS data
  317. file to be loaded.</p>
  318. <p style="margin-left:11%;"><b>LogDateAndTime</b></p>
  319. <p style="margin-left:22%;">Can be TRUE or FALSE. The
  320. default is TRUE. If set to FALSE, logging output does not
  321. include date and time. This is useful if you log to
  322. <b>stdout</b>(3) which is redirected to another logging
  323. mechanism that already includes date and time in its output,
  324. for instance <b>systemd-journald</b>(8). If you log to
  325. <b>syslog</b>(3), <b>LogDateAndTime</b> is ignored and date
  326. and time will never be included in the output sent to
  327. <b>syslog</b>(3). Using the command line you control this
  328. setting with options <b>-T0</b> and <b>-T1</b>.</p>
  329. <p style="margin-left:11%;"><b>LogVerbose</b></p>
  330. <p style="margin-left:22%;">Set this to either TRUE or
  331. FALSE. The default is FALSE. If set to TRUE, more details of
  332. each activation will be logged. You use <b>-v</b> and
  333. <b>-q</b> in the command line to control this setting.
  334. <b>LogVerbose</b> has an effect only if you specify a log
  335. file or redirect logging to <b>stdout</b>(3).</p>
  336. <p style="margin-left:11%;"><b>WhitelistingLevel</b></p>
  337. <p style="margin-left:22%;">Can be 0, 1, 2 or 3. The
  338. default is 0. Sets the whitelisting level to determine which
  339. products vlmcsd activates or refuses.</p>
  340. <p style="margin-left:29%; margin-top: 1em"><b>0</b>:
  341. activate all products with an unknown, retail or
  342. beta/preview KMS ID. <b><br>
  343. 1</b>: activate products with a retail or beta/preview KMS
  344. ID but refuse to activate products with an unknown KMS ID.
  345. <b><br>
  346. 2</b>: activate products with an unknown KMS ID but refuse
  347. products with a retail or beta/preview KMS ID. <b><br>
  348. 3</b>: activate only products with a known volume license
  349. RTM KMS ID and refuse all others.</p>
  350. <table width="100%" border="0" rules="none" frame="void"
  351. cellspacing="0" cellpadding="0">
  352. <tr valign="top" align="left">
  353. <td width="22%"></td>
  354. <td width="78%">
  355. <p>The SKU ID is not checked. Like a genuine KMS server
  356. vlmcsd activates a product that has a random or unknown SKU
  357. ID. If you select <b>1</b> or <b>3</b>, vlmcsd also checks
  358. the Application ID for correctness. If Microsoft introduces
  359. a new KMS ID for a new product, you cannot activate it if
  360. you used <b>1</b> or <b>3</b> until a new version of vlmcsd
  361. is available.</p></td></tr>
  362. </table>
  363. <p style="margin-left:11%;"><b>CheckClientTime</b></p>
  364. <p style="margin-left:22%;">Can be TRUE or FALSE. The
  365. default is FALSE. If you set this to TRUE <b>vlmcsd</b>(8)
  366. checks if the client time differs no more than four hours
  367. from the system time. This is useful to prevent emulator
  368. detection. A client that tries to detect an emulator could
  369. simply send two subsequent request with two time stamps that
  370. differ more than four hours from each other. If both
  371. requests succeed, the server is an emulator. If you set this
  372. to TRUE on a system with no reliable time source,
  373. activations will fail. It is ok to set the correct system
  374. time after you started <b>vlmcsd</b>(8).</p>
  375. <p style="margin-left:11%;"><b>MaintainClients</b></p>
  376. <p style="margin-left:22%;">Can be TRUE or FALSE (the
  377. default). Disables (FALSE) or enables (TRUE) maintaining a
  378. list of client machine IDs (CMIDs). TRUE is useful to
  379. prevent emulator detection. By maintaing a CMID list,
  380. <b>vlmcsd</b>(8) reports current active clients exactly like
  381. a genuine KMS emulator. This includes bug compatibility to
  382. the extent that you can permanently kill a genuine KMS
  383. emulator by sending an &quot;overcharge request&quot; with a
  384. required client count of 376 or more and then request
  385. activation for 671 clients. <b>vlmcsd</b>(8) can be reset
  386. from this condition by restarting it. If FALSE is used,
  387. <b>vlmcsd</b>(8) reports current active clients as good as
  388. possible. If no client sends an &quot;overcharge
  389. request&quot;, it is not possible to detect <b>vlmcsd</b>(8)
  390. as an emulator with
  391. <b>MaintainClients&nbsp;</b>=&nbsp;FALSE. Maintaining
  392. clients requires the allocation of a buffer that is about 50
  393. kB in size. On hardware with few memory resources use it
  394. only if you really need it.</p>
  395. <p style="margin-left:22%; margin-top: 1em">If you start
  396. <b>vlmcsd</b>(8) from an internet superserver, this setting
  397. cannot be used. Since <b>vlmcsd</b>(8) exits after each
  398. activation, it cannot maintain any state in memory.</p>
  399. <p style="margin-left:11%;"><b>StartEmpty</b></p>
  400. <p style="margin-left:22%;">This setting is ignored if you
  401. do not also specify <b>MaintainClients&nbsp;</b>=&nbsp;TRUE.
  402. If you specify FALSE (the default), <b>vlmcsd</b>(8) starts
  403. up as a fully &quot;charged&quot; KMS server. Clients
  404. activate immediately. <b>StartEmpty&nbsp;</b>=&nbsp;TRUE
  405. lets you start up <b>vlmcsd</b>(8) with an empty CMID list.
  406. Activation will start when the required minimum clients (25
  407. for Windows Client OSses, 5 for Windows Server OSses and
  408. Office) have registered with the KMS server. As long as the
  409. minimum client count has not been reached, clients end up in
  410. HRESULT 0xC004F038 &quot;The count reported by your Key
  411. Management Service (KMS) is insufficient. Please contact
  412. your system administrator&quot;. You may use <b>vlmcs</b>(1)
  413. or another KMS client emulator to &quot;charge&quot;
  414. <b>vlmcsd</b>(8). Setting this parameter to TRUE does not
  415. improve emulator detection prevention. It&rsquo;s primary
  416. purpose is to help developers of KMS clients to test
  417. &quot;charging&quot; a KMS server.</p>
  418. <p style="margin-left:11%;"><b>ActivationInterval</b></p>
  419. <p style="margin-left:22%;">This is the same as specifying
  420. <b>-A</b> on the command line. See <b>vlmcsd</b>(8) for
  421. details. The default is 2 hours. Example:
  422. ActivationInterval&nbsp;=&nbsp;1h</p>
  423. <p style="margin-left:11%;"><b>RenewalInterval</b></p>
  424. <p style="margin-left:22%;">This is the same as specifying
  425. <b>-R</b> on the command line. See <b>vlmcsd</b>(8) for
  426. details. The default is 7 days. Example: RenewalInterval =
  427. 3d. Please note that the KMS client decides itself when to
  428. renew activation. Even though vlmcsd sends the renewal
  429. interval you specify, it is no more than some kind of
  430. recommendation to the client. Older KMS clients did follow
  431. the recommendation from a KMS server or emulator. Newer
  432. clients do not.</p>
  433. <table width="100%" border="0" rules="none" frame="void"
  434. cellspacing="0" cellpadding="0">
  435. <tr valign="top" align="left">
  436. <td width="11%"></td>
  437. <td width="7%">
  438. <p><b>User</b></p></td>
  439. <td width="4%"></td>
  440. <td width="78%">
  441. <p>Run vlmcsd as another, preferrably less privileged,
  442. user. The <i>argument</i> can be a user name or a numeric
  443. user id. You must have the required privileges (capabilities
  444. on Linux) to change the security context of a process
  445. without providing any credentials (a password in most
  446. cases). On most unixoid OSses &rsquo;root&rsquo; is the only
  447. user who has these privileges in the default configuration.
  448. This setting is not available in the native Windows version
  449. of vlmcsd. See <b>-u</b> in <b>vlmcsd</b>(8). This setting
  450. cannot be changed on the fly by sending SIGHUP to
  451. vlmcsd.</p> </td></tr>
  452. <tr valign="top" align="left">
  453. <td width="11%"></td>
  454. <td width="7%">
  455. <p><b>Group</b></p></td>
  456. <td width="4%"></td>
  457. <td width="78%">
  458. <p>Run vlmcsd as another, preferrably less privileged,
  459. group. The <i>argument</i> can be a group name or a numeric
  460. group id. You must have the required privileges
  461. (capabilities on Linux) to change the security context of a
  462. process without providing any credentials (a password in
  463. most cases). On most unixoid OSses &rsquo;root&rsquo; is the
  464. only user who has these privileges in the default
  465. configuration. This setting is not available in the native
  466. Windows version of vlmcsd. See <b>-g</b> in
  467. <b>vlmcsd</b>(8). This setting cannot be changed on the fly
  468. by sending SIGHUP to vlmcsd.</p></td></tr>
  469. </table>
  470. <p style="margin-left:11%;"><b>Windows</b></p>
  471. <p style="margin-left:22%;">The <i>argument</i> has the
  472. form <i>ePID</i> [ / <i>HwId</i> ]. Always use <i>ePID</i>
  473. and <i>HwId</i> for Windows activations. If specified,
  474. <b>RandomizationLevel</b> for Windows activitations will be
  475. ignored.</p>
  476. <p style="margin-left:11%;"><b>Office2010</b></p>
  477. <p style="margin-left:22%;">The <i>argument</i> has the
  478. form <i>ePID</i> [ / <i>HwId</i> ]. Always use <i>ePID</i>
  479. and <i>HwId</i> for Office 2010 activations. If specified,
  480. <b>RandomizationLevel</b> for Office 2010 activitations will
  481. be ignored.</p>
  482. <p style="margin-left:11%;"><b>Office2013</b></p>
  483. <p style="margin-left:22%;">The <i>argument</i> has the
  484. form <i>ePID</i> [ / <i>HwId</i> ]. Always use <i>ePID</i>
  485. and <i>HwId</i> for Office 2013 activations. If specified,
  486. <b>RandomizationLevel</b> for Office 2013 activitations will
  487. be ignored.</p>
  488. <p style="margin-left:11%;"><b>Office2016</b></p>
  489. <p style="margin-left:22%;">The <i>argument</i> has the
  490. form <i>ePID</i> [ / <i>HwId</i> ]. Always use <i>ePID</i>
  491. and <i>HwId</i> for Office 2016 activations. If specified,
  492. <b>RandomizationLevel</b> for Office 2016 activitations will
  493. be ignored.</p>
  494. <h2>VALID EPIDS
  495. <a name="VALID EPIDS"></a>
  496. </h2>
  497. <p style="margin-left:11%; margin-top: 1em">The ePID is
  498. currently a comment only. You can specify any string up to
  499. 63 bytes. In Windows 7 Microsoft has blacklisted few ( &lt;
  500. 10 ) ePIDs that were used in KMSv5 versions of the
  501. &quot;Ratiborus Virtual Machine&quot;. Microsoft has given
  502. up on blacklisting when KMS emulators appeared in the
  503. wild.</p>
  504. <p style="margin-left:11%; margin-top: 1em">Even if you can
  505. use &quot;Activated by cool hacker guys&quot; as an ePID,
  506. you may wish to use ePIDs that cannot be detected as non-MS
  507. ePIDs. If you don&rsquo;t know how these &quot;valid&quot;
  508. ePIDs look like exactly, do not use GUIDS in vlmcsd.ini.
  509. vlmcsd provides internal mechanisms to generate valid
  510. ePIDs.</p>
  511. <p style="margin-left:11%; margin-top: 1em">If you use
  512. non-ASCII characters in your ePID (you shouldn&rsquo;t do
  513. anyway), these must be in UTF-8 format. This is especially
  514. important when you run vlmcsd on Windows or cygwin because
  515. UTF-8 is not the default encoding for most editors.</p>
  516. <p style="margin-left:11%; margin-top: 1em">If you are
  517. specifying an optional HWID it follows the same syntax as in
  518. the <b>-H</b> option in <b>vlmcsd</b>(8) ecxept that you
  519. must not enclose a HWID in quotes even if it contains
  520. spaces.</p>
  521. <h2>FILES
  522. <a name="FILES"></a>
  523. </h2>
  524. <p style="margin-left:11%; margin-top: 1em"><b>vlmcsd.ini</b>(5)</p>
  525. <h2>AUTHOR
  526. <a name="AUTHOR"></a>
  527. </h2>
  528. <p style="margin-left:11%; margin-top: 1em"><b>vlmcsd</b>(8)
  529. was written by crony12, Hotbird64 and vityan666. With
  530. contributions from DougQaid.</p>
  531. <h2>CREDITS
  532. <a name="CREDITS"></a>
  533. </h2>
  534. <p style="margin-left:11%; margin-top: 1em">Thanks to
  535. CODYQX4, deagles, eIcn, mikmik38, nosferati87, qad,
  536. Ratiborus, ...</p>
  537. <h2>SEE ALSO
  538. <a name="SEE ALSO"></a>
  539. </h2>
  540. <p style="margin-left:11%; margin-top: 1em"><b>vlmcsd</b>(8),
  541. <b>vlmcsd</b>(7), <b>vlmcs</b>(1), <b>vlmcsdmulti</b>(1)</p>
  542. <hr>
  543. </body>
  544. </html>