source: src-sh/pbi-manager10/man1/pbi_add.1 @ 651bd28

9.2-releasereleng/10.0releng/10.0.1releng/10.0.2releng/10.0.3releng/10.1releng/10.1.1
Last change on this file since 651bd28 was 651bd28, checked in by Kris Moore <kris@…>, 19 months ago

Add a new pbi-manager10 copy, this will be used for FreeBSD > 10

  • Property mode set to 100644
File size: 3.3 KB
Line 
1.Dd Apr 15, 2010
2.Dt PBI_ADD 1
3.Os
4.Sh NAME
5.Nm pbi_add
6.Nd Install a PBI file
7.Sh SYNOPSIS
8.Nm
9.Op Fl e
10.Op Fl f
11.Op Fl g
12.Op Fl i
13.Op Fl l
14.Op Fl r
15.Op Fl R
16.Op Fl v
17.Op Fl -checkscript
18.Op Fl -licagree
19.Op Fl -no-checksig
20.Op Fl -no-checksum
21.Op Fl -no-hash
22.Op Fl -repo Ar repoid
23.Op Fl -rArch Ar arch
24.Op Fl -rVer Ar version
25.Op Ar pbi
26.Sh DESCRIPTION
27The utility,
28.Nm ,
29installs, extracts or displays information from a pbi file
30packaged with pbi_create.
31.Sh WARNING
32The pbi_add command may execute scripts or programs contained
33within a PBI file. Your system may be susceptible to 'trojan horses'
34or other subtle attacks from malicious developers who create dangerous
35pbi files.
36
37You are advised to verify the competence and identify of those who provide
38PBI files. For extract protection, use the -e and --checkscript options
39to view archive contents and installation scripts prior to installing
40a PBI file.
41.Pp
42.Sh OPTIONS
43.Bl -tag -width indent
44.It Fl e
45Extract only, do not install. Will extract the archive to ~/<pbidirname>
46unless the -o option is used.
47.It Fl f
48Force installation, overwriting an already installed copy of the application
49.It Fl g
50Extract image data from header commonly used for GUI installations
51.It Fl i
52Display information about this PBI file
53.It Fl l
54Display LICENSE information for this PBI file.
55.It Fl o Ar outdir
56Specify the directory to use when only extracting the PBI with -e.
57.It Fl r
58Fetch and install the PBI file from the update server. The system architecture
59and version will be automatically determined to fetch the correct file.
60.It Fl R
61Fetch the install file from the update server, do not install. The system architecture
62and version will be automatically determined to fetch the correct file.
63.It Fl v
64Enable verbose output
65.It Fl -checkscript
66Display any custom scripts used in the installation / removal of this PBI file.
67Recommended that these be checked if the PBI file is suspect in any way.
68.It Fl -licagree
69Agree to LICENSE terms and conditions which may be required for installation.
70Viewing the license can be done with -l flag
71.It Fl -no-checksig
72Skip the openssl signature verification of the PBI data
73.It Fl -no-checksum
74Skip the checksum verification of the archive data.
75.It Fl -no-hash
76Disable using the shared-hash dir, which uses hard-links to share files
77between applications which are the same.
78.It Fl -repo Ar repoid
79When using -r to fetch a remote PBI, the --repo flag may be used to pick a specific
80repo to use. If not specified, then the repos will be searched by priority until
81a PBI match is found. Repo IDs may be found with the pbi_listrepo command.
82.It Fl -rArch Ar arch
83When using -r to fetch and install a PBI, the machine architecture is detected
84automatically. Using the -rArch <arch> flag allows you to manually specify the
85PBI arch type you wish to install, typically set to i386/amd64.
86.It Fl -rVer Ar version
87When using -r to fetch and install a PBI, the most recent version of that
88application is the default. Using the -rVer <version> flag allows you to
89specify a different version to install. A listing of available applications
90and versions is found with 'pbi_info -i'.
91used.
92.Sh NOTES
93For details about the module format, please refer to the wiki guide:
94http://wiki.pcbsd.org/index.php/PBI_Module_Builder_Guide
95.Sh SEE ALSO
96.Xr pbi_add 1 ,
97.Xr pbi_delete 1 ,
98.Xr pbi_makeport 1
Note: See TracBrowser for help on using the repository browser.