org.simantics.maps.server/node/node-v4.8.0-win-x64/node_modules/npm/doc/cli/npm-cache.md

   1 npm-cache(1) -- Manipulates packages cache
   2 ==========================================
   3
   4 ## SYNOPSIS
   5
   6     npm cache add <tarball file>
   7     npm cache add <folder>
   8     npm cache add <tarball url>
   9     npm cache add <name>@<version>
  10
  11     npm cache ls [<path>]
  12
  13     npm cache clean [<path>]
  14
  15 ## DESCRIPTION
  16
  17 Used to add, list, or clear the npm cache folder.
  18
  19 * add:
  20   Add the specified package to the local cache.  This command is primarily
  21   intended to be used internally by npm, but it can provide a way to
  22   add data to the local installation cache explicitly.
  23
  24 * ls:
  25   Show the data in the cache.  Argument is a path to show in the cache
  26   folder.  Works a bit like the `find` program, but limited by the
  27   `depth` config.
  28
  29 * clean:
  30   Delete data out of the cache folder.  If an argument is provided, then
  31   it specifies a subpath to delete.  If no argument is provided, then
  32   the entire cache is cleared.
  33
  34 ## DETAILS
  35
  36 npm stores cache data in the directory specified in `npm config get cache`.
  37 For each package that is added to the cache, three pieces of information are
  38 stored in `{cache}/{name}/{version}`:
  39
  40 * .../package/package.json:
  41   The package.json file, as npm sees it.
  42 * .../package.tgz:
  43   The tarball for that version.
  44
  45 Additionally, whenever a registry request is made, a `.cache.json` file
  46 is placed at the corresponding URI, to store the ETag and the requested
  47 data.  This is stored in `{cache}/{hostname}/{path}/.cache.json`.
  48
  49 Commands that make non-essential registry requests (such as `search` and
  50 `view`, or the completion scripts) generally specify a minimum timeout.
  51 If the `.cache.json` file is younger than the specified timeout, then
  52 they do not make an HTTP request to the registry.
  53
  54 ## CONFIGURATION
  55
  56 ### cache
  57
  58 Default: `~/.npm` on Posix, or `%AppData%/npm-cache` on Windows.
  59
  60 The root cache folder.
  61
  62 ## SEE ALSO
  63
  64 * npm-folders(5)
  65 * npm-config(1)
  66 * npm-config(7)
  67 * npmrc(5)
  68 * npm-install(1)
  69 * npm-publish(1)
  70 * npm-pack(1)