org.simantics.maps.server/node/node-v4.8.0-win-x64/node_modules/npm/man/man1/npm-cache.1

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