Lines Matching refs:NL
359 #define NL APR_EOL_STR
361 "### This file controls the configuration of the FSX filesystem." NL
362 "" NL
363 "[" SVN_CACHE_CONFIG_CATEGORY_MEMCACHED_SERVERS "]" NL
364 "### These options name memcached servers used to cache internal FSX" NL
365 "### data. See http://www.danga.com/memcached/ for more information on" NL
366 "### memcached. To use memcached with FSX, run one or more memcached" NL
367 "### servers, and specify each of them as an option like so:" NL
368 "# first-server = 127.0.0.1:11211" NL
369 "# remote-memcached = mymemcached.corp.example.com:11212" NL
370 "### The option name is ignored; the value is of the form HOST:PORT." NL
371 "### memcached servers can be shared between multiple repositories;" NL
372 "### however, if you do this, you *must* ensure that repositories have" NL
373 "### distinct UUIDs and paths, or else cached data from one repository" NL
374 "### might be used by another accidentally. Note also that memcached has" NL
375 "### no authentication for reads or writes, so you must ensure that your" NL
376 "### memcached servers are only accessible by trusted users." NL
377 "" NL
378 "[" CONFIG_SECTION_CACHES "]" NL
379 "### When a cache-related error occurs, normally Subversion ignores it" NL
380 "### and continues, logging an error if the server is appropriately" NL
381 "### configured (and ignoring it with file:// access). To make" NL
382 "### Subversion never ignore cache errors, uncomment this line." NL
383 "# " CONFIG_OPTION_FAIL_STOP " = true" NL
384 "" NL
385 "[" CONFIG_SECTION_REP_SHARING "]" NL
386 "### To conserve space, the filesystem can optionally avoid storing" NL
387 "### duplicate representations. This comes at a slight cost in" NL
388 "### performance, as maintaining a database of shared representations can" NL
389 "### increase commit times. The space savings are dependent upon the size" NL
390 "### of the repository, the number of objects it contains and the amount of" NL
391 "### duplication between them, usually a function of the branching and" NL
392 "### merging process." NL
393 "###" NL
394 "### The following parameter enables rep-sharing in the repository. It can" NL
395 "### be switched on and off at will, but for best space-saving results" NL
396 "### should be enabled consistently over the life of the repository." NL
397 "### 'svnadmin verify' will check the rep-cache regardless of this setting." NL
398 "### rep-sharing is enabled by default." NL
399 "# " CONFIG_OPTION_ENABLE_REP_SHARING " = true" NL
400 "" NL
401 "[" CONFIG_SECTION_DELTIFICATION "]" NL
402 "### To conserve space, the filesystem stores data as differences against" NL
403 "### existing representations. This comes at a slight cost in performance," NL
404 "### as calculating differences can increase commit times. Reading data" NL
405 "### will also create higher CPU load and the data will be fragmented." NL
406 "### Since deltification tends to save significant amounts of disk space," NL
407 "### the overall I/O load can actually be lower." NL
408 "###" NL
409 "### The options in this section allow for tuning the deltification" NL
410 "### strategy. Their effects on data size and server performance may vary" NL
411 "### from one repository to another." NL
412 "###" NL
413 "### During commit, the server may need to walk the whole change history of" NL
414 "### of a given node to find a suitable deltification base. This linear" NL
415 "### process can impact commit times, svnadmin load and similar operations." NL
416 "### This setting limits the depth of the deltification history. If the" NL
417 "### threshold has been reached, the node will be stored as fulltext and a" NL
418 "### new deltification history begins." NL
419 "### Note, this is unrelated to svn log." NL
420 "### Very large values rarely provide significant additional savings but" NL
421 "### can impact performance greatly - in particular if directory" NL
422 "### deltification has been activated. Very small values may be useful in" NL
423 "### repositories that are dominated by large, changing binaries." NL
424 "### Should be a power of two minus 1. A value of 0 will effectively" NL
425 "### disable deltification." NL
426 "### For 1.9, the default value is 1023." NL
427 "# " CONFIG_OPTION_MAX_DELTIFICATION_WALK " = 1023" NL
428 "###" NL
429 "### The skip-delta scheme used by FSX tends to repeatably store redundant" NL
430 "### delta information where a simple delta against the latest version is" NL
431 "### often smaller. By default, 1.9+ will therefore use skip deltas only" NL
432 "### after the linear chain of deltas has grown beyond the threshold" NL
433 "### specified by this setting." NL
434 "### Values up to 64 can result in some reduction in repository size for" NL
435 "### the cost of quickly increasing I/O and CPU costs. Similarly, smaller" NL
436 "### numbers can reduce those costs at the cost of more disk space. For" NL
437 "### rarely read repositories or those containing larger binaries, this may" NL
438 "### present a better trade-off." NL
439 "### Should be a power of two. A value of 1 or smaller will cause the" NL
440 "### exclusive use of skip-deltas." NL
441 "### For 1.8, the default value is 16." NL
442 "# " CONFIG_OPTION_MAX_LINEAR_DELTIFICATION " = 16" NL
443 "###" NL
444 "### After deltification, we compress the data through zlib to minimize on-" NL
445 "### disk size. That can be an expensive and ineffective process. This" NL
446 "### setting controls the usage of zlib in future revisions." NL
447 "### Revisions with highly compressible data in them may shrink in size" NL
448 "### if the setting is increased but may take much longer to commit. The" NL
449 "### time taken to uncompress that data again is widely independent of the" NL
450 "### compression level." NL
451 "### Compression will be ineffective if the incoming content is already" NL
452 "### highly compressed. In that case, disabling the compression entirely" NL
453 "### will speed up commits as well as reading the data. Repositories with" NL
454 "### many small compressible files (source code) but also a high percentage" NL
455 "### of large incompressible ones (artwork) may benefit from compression" NL
456 "### levels lowered to e.g. 1." NL
457 "### Valid values are 0 to 9 with 9 providing the highest compression ratio" NL
458 "### and 0 disabling it altogether." NL
459 "### The default value is 5." NL
460 "# " CONFIG_OPTION_COMPRESSION_LEVEL " = 5" NL
461 "" NL
462 "[" CONFIG_SECTION_PACKED_REVPROPS "]" NL
463 "### This parameter controls the size (in kBytes) of packed revprop files." NL
464 "### Revprops of consecutive revisions will be concatenated into a single" NL
465 "### file up to but not exceeding the threshold given here. However, each" NL
466 "### pack file may be much smaller and revprops of a single revision may be" NL
467 "### much larger than the limit set here. The threshold will be applied" NL
468 "### before optional compression takes place." NL
469 "### Large values will reduce disk space usage at the expense of increased" NL
470 "### latency and CPU usage reading and changing individual revprops. They" NL
471 "### become an advantage when revprop caching has been enabled because a" NL
472 "### lot of data can be read in one go. Values smaller than 4 kByte will" NL
473 "### not improve latency any further and quickly render revprop packing" NL
474 "### ineffective." NL
475 "### revprop-pack-size is 64 kBytes by default for non-compressed revprop" NL
476 "### pack files and 256 kBytes when compression has been enabled." NL
477 "# " CONFIG_OPTION_REVPROP_PACK_SIZE " = 64" NL
478 "###" NL
479 "### To save disk space, packed revprop files may be compressed. Standard" NL
480 "### revprops tend to allow for very effective compression. Reading and" NL
481 "### even more so writing, become significantly more CPU intensive. With" NL
482 "### revprop caching enabled, the overhead can be offset by reduced I/O" NL
483 "### unless you often modify revprops after packing." NL
484 "### Compressing packed revprops is enabled by default." NL
485 "# " CONFIG_OPTION_COMPRESS_PACKED_REVPROPS " = true" NL
486 "" NL
487 "[" CONFIG_SECTION_IO "]" NL
488 "### Parameters in this section control the data access granularity in" NL
489 "### format 7 repositories and later. The defaults should translate into" NL
490 "### decent performance over a wide range of setups." NL
491 "###" NL
492 "### When a specific piece of information needs to be read from disk, a" NL
493 "### data block is being read at once and its contents are being cached." NL
494 "### If the repository is being stored on a RAID, the block size should be" NL
495 "### either 50% or 100% of RAID block size / granularity. Also, your file" NL
496 "### system blocks/clusters should be properly aligned and sized. In that" NL
497 "### setup, each access will hit only one disk (minimizes I/O load) but" NL
498 "### uses all the data provided by the disk in a single access." NL
499 "### For SSD-based storage systems, slightly lower values around 16 kB" NL
500 "### may improve latency while still maximizing throughput." NL
501 "### Can be changed at any time but must be a power of 2." NL
502 "### block-size is given in kBytes and with a default of 64 kBytes." NL
503 "# " CONFIG_OPTION_BLOCK_SIZE " = 64" NL
504 "###" NL
505 "### The log-to-phys index maps data item numbers to offsets within the" NL
506 "### rev or pack file. This index is organized in pages of a fixed maximum" NL
507 "### capacity. To access an item, the page table and the respective page" NL
508 "### must be read." NL
509 "### This parameter only affects revisions with thousands of changed paths." NL
510 "### If you have several extremely large revisions (~1 mio changes), think" NL
511 "### about increasing this setting. Reducing the value will rarely result" NL
512 "### in a net speedup." NL
513 "### This is an expert setting. Must be a power of 2." NL
514 "### l2p-page-size is 8192 entries by default." NL
515 "# " CONFIG_OPTION_L2P_PAGE_SIZE " = 8192" NL
516 "###" NL
517 "### The phys-to-log index maps positions within the rev or pack file to" NL
518 "### to data items, i.e. describes what piece of information is being" NL
519 "### stored at any particular offset. The index describes the rev file" NL
520 "### in chunks (pages) and keeps a global list of all those pages. Large" NL
521 "### pages mean a shorter page table but a larger per-page description of" NL
522 "### data items in it. The latency sweet spot depends on the change size" NL
523 "### distribution but covers a relatively wide range." NL
524 "### If the repository contains very large files, i.e. individual changes" NL
525 "### of tens of MB each, increasing the page size will shorten the index" NL
526 "### file at the expense of a slightly increased latency in sections with" NL
527 "### smaller changes." NL
528 "### For source code repositories, this should be about 16x the block-size." NL
529 "### Must be a power of 2." NL
530 "### p2l-page-size is given in kBytes and with a default of 1024 kBytes." NL
531 "# " CONFIG_OPTION_P2L_PAGE_SIZE " = 1024" NL
533 #undef NL