VirtualBox

source: vbox/trunk/doc/manual/en_US/man_VBoxManage-extpack.xml@ 96300

最後變更 在這個檔案從96300是 96300,由 vboxsync 提交於 3 年 前

doc: comment fixing

  • 屬性 svn:eol-style 設為 native
  • 屬性 svn:keywords 設為 Author Date Id Revision
檔案大小: 5.4 KB
 
1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 manpage, user manual, usage: VBoxManage extpack
4-->
5<!--
6 Copyright (C) 2006-2020 Oracle Corporation
7
8 This file is part of VirtualBox Open Source Edition (OSE), as
9 available from http://www.alldomusa.eu.org. This file is free software;
10 you can redistribute it and/or modify it under the terms of the GNU
11 General Public License (GPL) as published by the Free Software
12 Foundation, in version 2 as it comes in the "COPYING" file of the
13 VirtualBox OSE distribution. VirtualBox OSE is distributed in the
14 hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
15-->
16<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
17 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
18<!ENTITY % all.entities SYSTEM "all-entities.ent">
19%all.entities;
20]>
21<refentry id="vboxmanage-extpack" lang="en">
22 <refentryinfo>
23 <pubdate>$Date: 2022-08-18 17:27:14 +0000 (Thu, 18 Aug 2022) $</pubdate>
24 <title>VBoxManage extpack</title>
25 </refentryinfo>
26
27 <refmeta>
28 <refentrytitle>VBoxManage-extpack</refentrytitle>
29 <manvolnum>1</manvolnum>
30 </refmeta>
31
32 <refnamediv>
33 <refname>VBoxManage-extpack</refname>
34 <refpurpose>extension package management</refpurpose>
35 <refclass>&product-name;</refclass>
36 </refnamediv>
37
38 <refsynopsisdiv>
39 <cmdsynopsis id="synopsis-vboxmanage-extpack-install"> <!-- The 'id' is mandatory and must start with 'synopsis-'. -->
40 <command>VBoxManage extpack install</command>
41 <arg>--replace</arg>
42 <arg>--accept-license=<replaceable>sha256</replaceable></arg>
43 <arg choice="req"><replaceable>tarball</replaceable></arg>
44 </cmdsynopsis>
45 <cmdsynopsis id="synopsis-vboxmanage-extpack-uninstall">
46 <command>VBoxManage extpack uninstall</command>
47 <arg>--force</arg>
48 <arg choice="req"><replaceable>name</replaceable></arg>
49 </cmdsynopsis>
50 <cmdsynopsis id="synopsis-vboxmanage-extpack-cleanup">
51 <command>VBoxManage extpack cleanup</command>
52 </cmdsynopsis>
53 </refsynopsisdiv>
54
55 <refsect1>
56 <title>Description</title>
57
58 <refsect2 id="vboxmanage-extpack-install">
59 <title>extpack install</title>
60 <remark role="help-copy-synopsis"/>
61 <para>
62 Installs a new extension pack on the system. This command will fail if an older
63 version of the same extension pack is already installed. The
64 <option>--replace</option> option can be used to uninstall any
65 old package before the new one is installed.
66 </para>
67 <variablelist>
68 <varlistentry>
69 <term><option>--replace</option></term><listitem><para>Uninstall existing extension pack version.</para></listitem>
70 </varlistentry>
71 <varlistentry>
72 <term><option>--accept-license=<replaceable>sha256</replaceable></option></term>
73 <listitem>
74 <para>Accept the license text with the given SHA-256 hash value.</para>
75 <para>VBoxManage will display the SHA-256 value when performing a manual
76 installation. The hash can of course be calculated by looking inside
77 the extension pack and using sha256sum or similar on the license file.</para>
78 </listitem>
79 </varlistentry>
80 <varlistentry>
81 <term><replaceable>tarball</replaceable></term>
82 <listitem>
83 <para>The file containing the extension pack to be installed.</para>
84 </listitem>
85 </varlistentry>
86 </variablelist>
87 </refsect2>
88
89 <refsect2 id="vboxmanage-extpack-uninstall">
90 <title>extpack uninstall</title>
91 <remark role="help-copy-synopsis"/>
92 <para>
93 Uninstalls an extension pack from the system. The subcommand will also succeed
94 in the case where the specified extension pack is not present on the system.
95 You can use <computeroutput>VBoxManage list extpacks</computeroutput> to show
96 the names of the extension packs which are currently installed.
97 </para>
98 <variablelist>
99 <varlistentry>
100 <term><option>--force</option></term>
101 <listitem>
102 <para>Overrides most refusals to uninstall an extension pack</para>
103 </listitem>
104 </varlistentry>
105 <varlistentry>
106 <term><replaceable>name</replaceable></term>
107 <listitem>
108 <para>The name of the extension pack to be uninstalled.</para>
109 </listitem>
110 </varlistentry>
111 </variablelist>
112 </refsect2>
113
114 <refsect2 id="vboxmanage-extpack-cleanup">
115 <title>extpack cleanup</title>
116 <remark role="help-copy-synopsis"/>
117 <para>
118 Used to remove temporary files and directories that may have been left behind
119 if a previous install or uninstall command failed.
120 </para>
121 </refsect2>
122
123 </refsect1>
124
125 <refsect1>
126 <title>Examples</title>
127 <remark role="help-scope" condition="EXTPACK_UNINSTALL,EXTPACK"/>
128 <para>
129 How to list extension packs:
130<screen>$ VBoxManage list extpacks
131Extension Packs: 1
132Pack no. 0: Oracle VM VirtualBox Extension Pack
133Version: 4.1.12
134Revision: 77218
135Edition:
136Description: USB 2.0 Host Controller, VirtualBox RDP, PXE ROM with E1000 support.
137VRDE Module: VBoxVRDP
138Usable: true
139Why unusable:</screen></para>
140
141 <para>How to remove an extension pack:
142<screen>$ VBoxManage extpack uninstall "Oracle VM VirtualBox Extension Pack"
1430%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%
144Successfully uninstalled "Oracle VM VirtualBox Extension Pack".</screen></para>
145 </refsect1>
146
147</refentry>
148
注意: 瀏覽 TracBrowser 來幫助您使用儲存庫瀏覽器

© 2025 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette