Don't use relative paths, make people set $PATH.
[febootstrap.git] / febootstrap-install.pod
1 =head1 NAME
2
3 febootstrap-install - Install a file in an febootstrap root filesystem
4
5 =head1 SYNOPSIS
6
7  febootstrap-install ROOT LOCALFILE TARGETPATH MODE OWNER[.GROUP]
8
9 =head1 DESCRIPTION
10
11 This can be used to safely install a new file in an febootstrap
12 root filesystem.
13
14 Just copying a file in isn't usually safe, for reasons which are to do
15 with the L<fakeroot(8)> command.
16
17 =head1 EXAMPLE
18
19  febootstrap-install initramfs new-fstab /etc/fstab ugo=rw root.root
20
21 =head1 SEE ALSO
22
23 L<febootstrap(8)>,
24 L<febootstrap-run(8)>,
25 L<fakeroot(1)>,
26 L<fakechroot(1)>.
27
28 =head1 AUTHORS
29
30 Richard W.M. Jones <rjones @ redhat . com>
31
32 =head1 COPYRIGHT
33
34 (C) Copyright 2009 Red Hat Inc.,
35 L<http://et.redhat.com/~rjones/febootstrap>.
36
37 This program is free software; you can redistribute it and/or modify
38 it under the terms of the GNU General Public License as published by
39 the Free Software Foundation; either version 2 of the License, or
40 (at your option) any later version.
41
42 This program is distributed in the hope that it will be useful,
43 but WITHOUT ANY WARRANTY; without even the implied warranty of
44 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
45 GNU General Public License for more details.
46
47 You should have received a copy of the GNU General Public License
48 along with this program; if not, write to the Free Software
49 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.