ff4712a48de5598cc481be05d76dde566a77d06c
[platform/upstream/nodejs.git] / deps / npm / man / man1 / npm-ls.1
1 .\" Generated with Ronnjs 0.3.8
2 .\" http://github.com/kapouer/ronnjs/
3 .
4 .TH "NPM\-LS" "1" "December 2013" "" ""
5 .
6 .SH "NAME"
7 \fBnpm-ls\fR \-\- List installed packages
8 .
9 .SH "SYNOPSIS"
10 .
11 .nf
12 npm list [<pkg> \.\.\.]
13 npm ls [<pkg> \.\.\.]
14 npm la [<pkg> \.\.\.]
15 npm ll [<pkg> \.\.\.]
16 .
17 .fi
18 .
19 .SH "DESCRIPTION"
20 This command will print to stdout all the versions of packages that are
21 installed, as well as their dependencies, in a tree\-structure\.
22 .
23 .P
24 Positional arguments are \fBname@version\-range\fR identifiers, which will
25 limit the results to only the paths to the packages named\.  Note that
26 nested packages will \fIalso\fR show the paths to the specified packages\.
27 For example, running \fBnpm ls promzard\fR in npm\'s source tree will show:
28 .
29 .IP "" 4
30 .
31 .nf
32 npm@1.3.17 /path/to/npm
33 └─┬ init\-package\-json@0\.0\.4
34   └── promzard@0\.1\.5
35 .
36 .fi
37 .
38 .IP "" 0
39 .
40 .P
41 It will print out extraneous, missing, and invalid packages\.
42 .
43 .P
44 If a project specifies git urls for dependencies these are shown
45 in parentheses after the name@version to make it easier for users to
46 recognize potential forks of a project\.
47 .
48 .P
49 When run as \fBll\fR or \fBla\fR, it shows extended information by default\.
50 .
51 .SH "CONFIGURATION"
52 .
53 .SS "json"
54 .
55 .IP "\(bu" 4
56 Default: false
57 .
58 .IP "\(bu" 4
59 Type: Boolean
60 .
61 .IP "" 0
62 .
63 .P
64 Show information in JSON format\.
65 .
66 .SS "long"
67 .
68 .IP "\(bu" 4
69 Default: false
70 .
71 .IP "\(bu" 4
72 Type: Boolean
73 .
74 .IP "" 0
75 .
76 .P
77 Show extended information\.
78 .
79 .SS "parseable"
80 .
81 .IP "\(bu" 4
82 Default: false
83 .
84 .IP "\(bu" 4
85 Type: Boolean
86 .
87 .IP "" 0
88 .
89 .P
90 Show parseable output instead of tree view\.
91 .
92 .SS "global"
93 .
94 .IP "\(bu" 4
95 Default: false
96 .
97 .IP "\(bu" 4
98 Type: Boolean
99 .
100 .IP "" 0
101 .
102 .P
103 List packages in the global install prefix instead of in the current
104 project\.
105 .
106 .SH "SEE ALSO"
107 .
108 .IP "\(bu" 4
109 npm help config
110 .
111 .IP "\(bu" 4
112 npm help  config
113 .
114 .IP "\(bu" 4
115 npm help  npmrc
116 .
117 .IP "\(bu" 4
118 npm help  folders
119 .
120 .IP "\(bu" 4
121 npm help install
122 .
123 .IP "\(bu" 4
124 npm help link
125 .
126 .IP "\(bu" 4
127 npm help prune
128 .
129 .IP "\(bu" 4
130 npm help outdated
131 .
132 .IP "\(bu" 4
133 npm help update
134 .
135 .IP "" 0
136