VirtualBox

Changeset 49349 in vbox for trunk/doc/manual/en_US


Ignore:
Timestamp:
Oct 31, 2013 4:40:46 PM (11 years ago)
Author:
vboxsync
Message:

Guest Control:

  • Implemented IGuestSession::DirectoryRemove, IGuestSession::DirectoryRemoveRecursive, IGuestSession::DirectoryRename + IGuestSession::FileRename.
  • Added appropriate commands to VBoxManage (basic support for now).
  • Implemented support for proper guest session process termination via SCM.
  • Implemented support for internal anonymous wait events which are not relying on the public API's VBoxEventType_T.
  • Various bugfixes.
File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/doc/manual/en_US/user_VBoxManage.xml

    r49313 r49349  
    31623162
    31633163        <listitem>
     3164          <para><emphasis role="bold"><computeroutput>removedirectory</computeroutput></emphasis>,
     3165          which allows deletion of guest directories (only with installed Guest
     3166          Additions 4.3.2 and later).</para>
     3167
     3168          <screen>VBoxManage guestcontrol &lt;uuid|vmname&gt; removedir[ectory]|rmdir
     3169            &lt;guest directory&gt;... --username &lt;name&gt;
     3170            [--passwordfile &lt;file&gt; | --password &lt;password&gt;]
     3171            [--recursive|-R|-r] [--verbose]</screen>
     3172
     3173          <para>where the parameters mean: <glosslist>
     3174              <glossentry>
     3175                <glossterm><computeroutput>uuid|vmname</computeroutput></glossterm>
     3176
     3177                <glossdef>
     3178                  <para>The VM UUID or VM name. Mandatory.</para>
     3179                </glossdef>
     3180              </glossentry>
     3181
     3182              <glossentry>
     3183                <glossterm><computeroutput>directory to remove on guest</computeroutput></glossterm>
     3184
     3185                <glossdef>
     3186                  <para>Absolute path of directory/directories to remove on
     3187                  guest, e.g. <computeroutput>D:\Foo\Bar</computeroutput>. The
     3188                  specified user must have appropriate rights to delete the
     3189                  specified guest directories.</para>
     3190                </glossdef>
     3191              </glossentry>
     3192
     3193              <glossentry>
     3194                <glossterm><computeroutput>--username &lt;name&gt;</computeroutput></glossterm>
     3195
     3196                <glossdef>
     3197                  <para>Name of the user the copy process should run under.
     3198                  This user must exist on the guest OS.</para>
     3199                </glossdef>
     3200              </glossentry>
     3201
     3202              <glossentry>
     3203                <glossterm><computeroutput>--passwordfile &lt;file&gt;</computeroutput></glossterm>
     3204
     3205                <glossdef>
     3206                  <para>Password of the user account specified to be read from
     3207                  the given file. If not given, an empty password is
     3208                  assumed.</para>
     3209                </glossdef>
     3210              </glossentry>
     3211
     3212              <glossentry>
     3213                <glossterm><computeroutput>--password &lt;password&gt;</computeroutput></glossterm>
     3214
     3215                <glossdef>
     3216                  <para>Password of the user account specified with
     3217                  <computeroutput>--username</computeroutput>. If not given,
     3218                  an empty password is assumed.</para>
     3219                </glossdef>
     3220              </glossentry>
     3221
     3222              <glossentry>
     3223                <glossterm><computeroutput>--recursive</computeroutput></glossterm>
     3224
     3225                <glossdef>
     3226                  <para>Remove directories and their contents recursively.</para>
     3227                </glossdef>
     3228              </glossentry>
     3229
     3230              <glossentry>
     3231                <glossterm><computeroutput>--verbose</computeroutput></glossterm>
     3232
     3233                <glossdef>
     3234                  <para>Tells VBoxManage to be more verbose.</para>
     3235                </glossdef>
     3236              </glossentry>
     3237            </glosslist></para>
     3238        </listitem>
     3239
     3240        <listitem>
     3241          <para><emphasis role="bold"><computeroutput>removefile</computeroutput></emphasis>,
     3242          which allows deletion of guest files (only with installed Guest
     3243          Additions 4.3.2 and later).</para>
     3244
     3245          <screen>VBoxManage guestcontrol &lt;uuid|vmname&gt; removefile|rm
     3246            &lt;guest file&gt;... --username &lt;name&gt;
     3247            [--passwordfile &lt;file&gt; | --password &lt;password&gt;]
     3248            [--verbose]</screen>
     3249
     3250          <para>where the parameters mean: <glosslist>
     3251              <glossentry>
     3252                <glossterm><computeroutput>uuid|vmname</computeroutput></glossterm>
     3253
     3254                <glossdef>
     3255                  <para>The VM UUID or VM name. Mandatory.</para>
     3256                </glossdef>
     3257              </glossentry>
     3258
     3259              <glossentry>
     3260                <glossterm><computeroutput>file to remove on guest</computeroutput></glossterm>
     3261
     3262                <glossdef>
     3263                  <para>Absolute path of a file/files to remove on
     3264                  guest, e.g. <computeroutput>D:\Foo\Bar\text.txt</computeroutput>. The
     3265                  specified user must have appropriate rights to delete the
     3266                  specified guest files.</para>
     3267                </glossdef>
     3268              </glossentry>
     3269
     3270              <glossentry>
     3271                <glossterm><computeroutput>--username &lt;name&gt;</computeroutput></glossterm>
     3272
     3273                <glossdef>
     3274                  <para>Name of the user the copy process should run under.
     3275                  This user must exist on the guest OS.</para>
     3276                </glossdef>
     3277              </glossentry>
     3278
     3279              <glossentry>
     3280                <glossterm><computeroutput>--passwordfile &lt;file&gt;</computeroutput></glossterm>
     3281
     3282                <glossdef>
     3283                  <para>Password of the user account specified to be read from
     3284                  the given file. If not given, an empty password is
     3285                  assumed.</para>
     3286                </glossdef>
     3287              </glossentry>
     3288
     3289              <glossentry>
     3290                <glossterm><computeroutput>--password &lt;password&gt;</computeroutput></glossterm>
     3291
     3292                <glossdef>
     3293                  <para>Password of the user account specified with
     3294                  <computeroutput>--username</computeroutput>. If not given,
     3295                  an empty password is assumed.</para>
     3296                </glossdef>
     3297              </glossentry>
     3298
     3299              <glossentry>
     3300                <glossterm><computeroutput>--verbose</computeroutput></glossterm>
     3301
     3302                <glossdef>
     3303                  <para>Tells VBoxManage to be more verbose.</para>
     3304                </glossdef>
     3305              </glossentry>
     3306            </glosslist></para>
     3307        </listitem>
     3308
     3309        <listitem>
     3310          <para><emphasis role="bold"><computeroutput>ren[ame]|mv</computeroutput></emphasis>,
     3311          which allows renaming of guest files and/or directories (only with installed Guest
     3312          Additions 4.3.2 and later).</para>
     3313
     3314          <screen>VBoxManage guestcontrol &lt;uuid|vmname&gt; ren[ame]|mv
     3315            &lt;source&gt;... &lt;dest&gt; --username &lt;name&gt;
     3316            [--passwordfile &lt;file&gt; | --password &lt;password&gt;]
     3317            [--verbose]</screen>
     3318
     3319          <para>where the parameters mean: <glosslist>
     3320              <glossentry>
     3321                <glossterm><computeroutput>uuid|vmname</computeroutput></glossterm>
     3322
     3323                <glossdef>
     3324                  <para>The VM UUID or VM name. Mandatory.</para>
     3325                </glossdef>
     3326              </glossentry>
     3327
     3328              <glossentry>
     3329                <glossterm><computeroutput>source</computeroutput></glossterm>
     3330
     3331                <glossdef>
     3332                  <para>Absolute path of one or more source(s) to move to
     3333                  destination. If more than one source is specified, destination
     3334                  must be an existing directory on the guest. The specified user
     3335                  must have appropriate rights to access source and destination
     3336                  files and directories.</para>
     3337                </glossdef>
     3338              </glossentry>
     3339
     3340              <glossentry>
     3341                <glossterm><computeroutput>dest</computeroutput></glossterm>
     3342
     3343                <glossdef>
     3344                  <para>Absolute path of the destination to move the source(s)
     3345                  to. This can be a directory or a file, depending if one or more
     3346                  sources have been specified. The specified user
     3347                  must have appropriate rights to access the destination
     3348                  file and directory.</para>
     3349                </glossdef>
     3350              </glossentry>
     3351
     3352              <glossentry>
     3353                <glossterm><computeroutput>--username &lt;name&gt;</computeroutput></glossterm>
     3354
     3355                <glossdef>
     3356                  <para>Name of the user the copy process should run under.
     3357                  This user must exist on the guest OS.</para>
     3358                </glossdef>
     3359              </glossentry>
     3360
     3361              <glossentry>
     3362                <glossterm><computeroutput>--passwordfile &lt;file&gt;</computeroutput></glossterm>
     3363
     3364                <glossdef>
     3365                  <para>Password of the user account specified to be read from
     3366                  the given file. If not given, an empty password is
     3367                  assumed.</para>
     3368                </glossdef>
     3369              </glossentry>
     3370
     3371              <glossentry>
     3372                <glossterm><computeroutput>--password &lt;password&gt;</computeroutput></glossterm>
     3373
     3374                <glossdef>
     3375                  <para>Password of the user account specified with
     3376                  <computeroutput>--username</computeroutput>. If not given,
     3377                  an empty password is assumed.</para>
     3378                </glossdef>
     3379              </glossentry>
     3380
     3381              <glossentry>
     3382                <glossterm><computeroutput>--verbose</computeroutput></glossterm>
     3383
     3384                <glossdef>
     3385                  <para>Tells VBoxManage to be more verbose.</para>
     3386                </glossdef>
     3387              </glossentry>
     3388            </glosslist></para>
     3389        </listitem>
     3390
     3391        <listitem>
    31643392          <para><emphasis role="bold"><computeroutput>createtemporary</computeroutput></emphasis>,
    31653393          which allows
Note: See TracChangeset for help on using the changeset viewer.

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