Changes between Version 106 and Version 107 of VboxApps

Timestamp:

Jan 29, 2017, 12:32:05 PM (7 years ago)

Author:

davea

Comment:

--

VboxApps

@@ -110 +110 @@
    [ <completion_trigger_file>filename</completion_trigger_file> ]
    [ <copy_to_shared>filename</copy_to_shared> ]
+   [ <copy_cmdline_to_shared>0|1</copy_cmdline_to_shared> ]
    [ <enable_cache_disk>0|1</enable_cache_disk> ]
    [ <enable_cern_dataformat>0|1</enable_cern_dataformat> ]
@@ -137 +138 @@
 Required elements:
 
- '''memory_size_mb''':: the amount of physical memory allocated to the VM, in megabytes.
- '''os_name''':: the name of the guest OS as defined by !VirtualBox,
+ '''memory_size_mb''':: The amount of physical memory allocated to the VM, in megabytes.
+ '''os_name''':: The name of the guest OS as defined by !VirtualBox,
    e.g. "Linux26", "Linux26_64", "Linux24", etc.
    To see a list of all available OS names, install !VirtualBox on a system,
@@ -153 +154 @@
    If vboxwrapper finds this file,
    it cleans up the VM and exits with the given code (default 0).
- '''copy_to_shared''':: copy the given file from the slot directory the shared directory before launch.
+ '''copy_to_shared''':: Copy the given file from the slot directory the shared directory before launch.
   For example, you can use to copy '''init_data.xml''' into the VM.
   This directive can be used more than once.
+ '''copy_cmdline_to_shared''':: Write vboxwrapper's command line to a file '''shared/cmdline'''.
+  This lets you pass information into the VM without input files.
+  The max size of the command line is on the order of 60KB.
  '''enable_cache_disk''':: Mount a virtual disk in the VM.
    The virtual disk is described by a VDI file in the app version
    with logical name '''vm_cache.vdi''' and the '''copy_file''' attribute.
- '''enable_cern_dataformat'''::  if '''enable_floppyio''' is used (see below)
+ '''enable_cern_dataformat'''::  If '''enable_floppyio''' is used (see below)
    initialize the floppy disk image to contain user and host ID and credit
    as name=value pairs.
- '''enable_isocontextualization''':: the VM image is an ISO file named '''vm_isocontext.iso''',
+ '''enable_isocontextualization''':: The VM image is an ISO file named '''vm_isocontext.iso''',
    rather than a VDI file.
    Also, vboxwrapper will mount the host's guest additions ISO (VBoxGuestAdditions.iso)
    as a DVD in the VM.
- '''enable_floppyio''':: create a floppy disk image in the VM,
+ '''enable_floppyio''':: Create a floppy disk image in the VM,
   containing the contents of init_data.xml.
- '''enable_network''':: if present, allow the VM to do network access.
+ '''enable_network''':: If present, allow the VM to do network access.
  '''enable_remotedesktop''':: If the Oracle VirtualBox Extension are installed, it'll enable
   the use of a remote desktop client to view the console of the VM.
- '''enable_shared_directory''':: if present, create a directory that is shared
+ '''enable_shared_directory''':: If present, create a directory that is shared
    between the host OS and the guest OS.
    Must be set if your application has input or output files.
- '''enable_graphics_support''':: if present, creates and updates a [BasicApi#GraphicsStatus graphics status] file.
+ '''enable_graphics_support''':: If present, creates and updates a [BasicApi#GraphicsStatus graphics status] file.
    This is used by [http://boinc.berkeley.edu/trac/wiki/HTMLGfx HTMLGfx]. (v26155+)
  '''boot_iso''':: if both a disk and an ISO are specified to be attached to the VM, by default the VM will 
    first attempt to boot from the disk. with '''boot_iso''' given, it will instead first boot from the ISO. 
- '''fraction_done_filename''':: the name of a file to which the app will
+ '''fraction_done_filename''':: The name of a file to which the app will
   periodically write its fraction done (0 to 1).
   This is used by the wrapper to report overall fraction done.
- '''intermediate_upload_file'''::: specifies the name of an output file that,
+ '''intermediate_upload_file'''::: Specifies the name of an output file that,
   when present, should be uploaded as soon as possible.
- '''job_duration''':: this specifies the maximum elapsed time of the job,
+ '''job_duration''':: Specifies the maximum elapsed time of the job,
   after which vboxwrapper will kill the VM and exit normally.
- '''minimum_checkpoint_interval''':: minimum number of seconds before a checkpoint/snapshot can be created.
+ '''minimum_checkpoint_interval''':: Minimum number of seconds before a checkpoint/snapshot can be created.
   Defaults to 10 minutes. (v26086+)
- '''network_bridged_mode''':: if '''enable_network''' is set, use bridged mode; default is NAT mode.
- '''pf_guest_port''':: enable port forwarding to port N within the VM.
+ '''network_bridged_mode''':: If '''enable_network''' is set, use bridged mode; default is NAT mode.
+ '''pf_guest_port''':: Enable port forwarding to port N within the VM.
   This is assumed to be a web server providing application graphics.
- '''port_forward''':: defines a port forwarding between the given host and guest ports.
+ '''port_forward''':: Defines a port forwarding between the given host and guest ports.
     If '''nports''' is specified, N ports will be forwarded:
     H to G, H+1 to G+1, ... H+N-1 to G+N-1.
@@ -196 +200 @@
     otherwise they can be accessed only from processes on this computer.
    There may be more than one of these elements.
- '''temporary_exit_trigger_file''':: specifies the name of a file that, if present,
+ '''temporary_exit_trigger_file''':: Specifies the name of a file that, if present,
    causes the wrapper to temporarily exit.
- '''trickle_trigger_file''':: provides a mechanism for the VM to send trickle-up messages.
+ '''trickle_trigger_file''':: Provides a mechanism for the VM to send trickle-up messages.
    If a file of the given name appears in the shared directory,
    vboxwrapper sends a [TrickleApi trickle-up message] whose variety is the filename
    and whose contents is the contents of the file, then deletes the file.
- '''vm_disk_controller_model''':: which disk controller model to emulate.
- '''vm_disk_controller_type''':: which disk controller type to emulate.
+ '''vm_disk_controller_model''':: Which disk controller model to emulate.
+ '''vm_disk_controller_type''':: Which disk controller type to emulate.
 
 == Vboxwrapper command-line options ==