summaryrefslogtreecommitdiff
path: root/deps/npm/man/man1/cache.1
blob: 6b828e7f2252889cd74ce31a9e9bc4c4438c0a2b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
.\" Generated with Ronnjs/v0.1
.\" http://github.com/kapouer/ronnjs/
.
.TH "NPM\-CACHE" "1" "May 2012" "" ""
.
.SH "NAME"
\fBnpm-cache\fR \-\- Manipulates packages cache
.
.SH "SYNOPSIS"
.
.nf
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>]
.
.fi
.
.SH "DESCRIPTION"
Used to add, list, or clear the npm cache folder\.
.
.IP "\(bu" 4
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\.
.
.IP "\(bu" 4
ls:
Show the data in the cache\.  Argument is a path to show in the cache
folder\.  Works a bit like the \fBfind\fR program, but limited by the \fBdepth\fR config\.
.
.IP "\(bu" 4
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\.
.
.IP "" 0
.
.SH "DETAILS"
npm stores cache data in \fB$HOME/\.npm\fR\|\.  For each package that is added
to the cache, three pieces of information are stored in \fB{cache}/{name}/{version}\fR:
.
.IP "\(bu" 4
\|\.\.\./package/:
A folder containing the package contents as they appear in the tarball\.
.
.IP "\(bu" 4
\|\.\.\./package\.json:
The package\.json file, as npm sees it, with overlays applied and a _id attribute\.
.
.IP "\(bu" 4
\|\.\.\./package\.tgz:
The tarball for that version\.
.
.IP "" 0
.
.P
Additionally, whenever a registry request is made, a \fB\|\.cache\.json\fR file
is placed at the corresponding URI, to store the ETag and the requested
data\.
.
.P
Commands that make non\-essential registry requests (such as \fBsearch\fR and \fBview\fR, or the completion scripts) generally specify a minimum timeout\.
If the \fB\|\.cache\.json\fR file is younger than the specified timeout, then
they do not make an HTTP request to the registry\.
.
.SH "CONFIGURATION"
.
.SS "cache"
Default: \fB$HOME/\.npm\fR on Posix, or \fB$HOME/npm\-cache\fR on Windows\.
.
.P
The root cache folder\.
.
.SH "SEE ALSO"
.
.IP "\(bu" 4
npm help folders
.
.IP "\(bu" 4
npm help config
.
.IP "\(bu" 4
npm help install
.
.IP "\(bu" 4
npm help publish
.
.IP "\(bu" 4
npm help pack
.
.IP "" 0