blob: b5fba9f3cbbe4648cc375ff0e90607d5f2059e85 (
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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
=pod
=head1 NAME
pkg - Package maintenance utility
=head1 SYNOPSIS
B<pkg> I<action> [ I<arguments> ]
=head1 DESCRIPTION
B<pkg> is the basic script for maintaining packages
I<action> may be one of:
=over
=item B<add>|B<install> I<package>
fetch given I<package> from the package_root and install it
=item B<changelog> I<package>
Show I<package>'s changelog (if available)
=item B<changeroot> I<source>
Change the default source on all packages to I<source>
Example: `changeroot ssh://kraftwerk/var/packages_root` will change
the source of core to 'ssh://kraftwerk/var/packages_root/core'
=item B<check> [ I<package> ]
Check dependencies, conflicts and symlinks of I<package>.
If no argument is given, checks all installed packages
=item B<delete>|B<remove> I<package>
Remove I<package> from the local packages tree
=item B<eval> I<expression>
Evauluate I<expression>, e.g. to manually execute a hook
=item B<info> I<package>
Show information on I<package>, like dependencies, version, etc
=item B<list>
List all installed packages
=item B<list-all>
List all available (both installed and not installed packages
Hint: `diff <(pkg list) <(pkg list-all)` will show all packages
that are currently not installed
=item B<local-update>
Update the local package list
=item B<log> I<package>
Show commit history for package
=item B<push> [ I<package> ]
push new local versions to PKG_ROOT.
If no argument is given, pushes all installed packages
=item B<remote-update>
Update remote package list
=item B<status> [ I<package> ]
Check for local changes to the I<package>'s files.
If no arguments is given, checks all installed packages
=item B<update>
Update local and remote package list
=item B<upgrade> [ I<package> ]
retrieve and install newest available version of I<package>.
If no argument is given, updates all installed packages
=back
=head1 FILES
=over
=item F<~/.pkg.conf>
Contains configuration vars
=back
=head1 CAVEATS
On the server holding the PKG_ROOT, core/include/pkglist must be executed for
pkg upgrade and pkg push to work properly. It's recommended to execute it as
cronjob. A concept to execute it 'on demand' is planned.
=head1 EXAMPLES
=over
=item * B<pkg remote-update; pkg upgrade>
Get new stuff from the packages_root
=item * B<pkg local-update; pkg push>
Push local changes to the packages_root
=item * B<pkg eval exec_hook core post-update; pkg eval populate_collected core>
Update the core package after local changes.
(Yeah, this sucks. I'm working out a better way)
=back
=head1 AUTHOR
Daniel Friesel <derf@derf.homelinux.org>
=head1 SEE ALSO
L<pkg.conf>(5)
=cut
vim:ft=pod
|
