mirror of https://github.com/lukechilds/node.git
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
71 lines
1.9 KiB
71 lines
1.9 KiB
13 years ago
|
npm-cache(1) -- Manipulates packages cache
|
||
|
|
==========================================
|
||
|
|
|
||
|
|
## SYNOPSIS
|
||
|
|
|
||
|
|
npm cache add <tarball file>
|
||
|
|
npm cache add <folder>
|
||
|
|
npm cache add <tarball url>
|
||
|
|
npm cache add <name>@<version>
|
||
|
|
|
||
|
|
npm cache ls [<path>]
|
||
|
|
|
||
|
|
npm cache clean [<path>]
|
||
|
|
|
||
|
|
## DESCRIPTION
|
||
|
|
|
||
|
|
Used to add, list, or clear the npm cache folder.
|
||
|
|
|
||
|
|
* add:
|
||
|
|
Add the specified package to the local cache. This command is primarily
|
||
|
|
intended to be used internally by npm, but it can provide a way to
|
||
|
|
add data to the local installation cache explicitly.
|
||
|
|
|
||
|
|
* ls:
|
||
|
|
Show the data in the cache. Argument is a path to show in the cache
|
||
|
|
folder. Works a bit like the `find` program, but limited by the
|
||
|
|
`depth` config.
|
||
|
|
|
||
|
|
* clean:
|
||
|
|
Delete data out of the cache folder. If an argument is provided, then
|
||
|
|
it specifies a subpath to delete. If no argument is provided, then
|
||
|
|
the entire cache is cleared.
|
||
|
|
|
||
|
|
## DETAILS
|
||
|
|
|
||
|
|
npm stores cache data in `$HOME/.npm`. For each package that is added
|
||
|
|
to the cache, three pieces of information are stored in
|
||
|
|
`{cache}/{name}/{version}`:
|
||
|
|
|
||
|
|
* .../package/:
|
||
|
|
A folder containing the package contents as they appear in the tarball.
|
||
|
|
* .../package.json:
|
||
|
|
The package.json file, as npm sees it, with overlays applied and a _id attribute.
|
||
|
|
* .../package.tgz:
|
||
|
|
The tarball for that version.
|
||
|
|
|
||
|
|
Additionally, whenever a registry request is made, a `.cache.json` file
|
||
|
|
is placed at the corresponding URI, to store the ETag and the requested
|
||
|
|
data.
|
||
|
|
|
||
|
|
Commands that make non-essential registry requests (such as `search` and
|
||
|
|
`view`, or the completion scripts) generally specify a minimum timeout.
|
||
|
|
If the `.cache.json` file is younger than the specified timeout, then
|
||
|
|
they do not make an HTTP request to the registry.
|
||
|
|
|
||
|
|
## CONFIGURATION
|
||
|
|
|
||
|
|
### cache
|
||
|
|
|
||
|
|
Default: `$HOME/.npm` on Posix, or `$HOME/npm-cache` on Windows.
|
||
|
|
|
||
|
|
The root cache folder.
|
||
|
|
|
||
|
|
## SEE ALSO
|
||
|
|
|
||
|
|
* npm-folders(1)
|
||
|
|
* npm-config(1)
|
||
|
|
* npm-install(1)
|
||
|
|
* npm-publish(1)
|
||
|
|
* npm-pack(1)
|