/* ********************************************************************* * Copyright (c) 2007 VMware, Inc. * All rights not expressly granted to you by VMware, Inc. are reserved. * *********************************************************************/ /* * This demonstrates how to set up and use guest operations. * This assumes that the guest OS is Linux. * * It executes 'ls' on the guest OS, redirecting it to a file. * It then copies that output file to the host. * Finally it cleans up on the guest. */ #include #include #include "vix.h" /* * guest OS username/password */ #define GUEST_USERNAME "testuser" #define GUEST_PASSWORD "foobar" /* * Certain arguments differ when using VIX with VMware Server 2.0 * and VMware Workstation. * * Comment out this definition to use this code with VMware Server 2.0. */ #define USE_WORKSTATION #ifdef USE_WORKSTATION #define CONNTYPE VIX_SERVICEPROVIDER_VMWARE_WORKSTATION #define HOSTNAME "" #define HOSTPORT 0 #define USERNAME "" #define PASSWORD "" #define VMPOWEROPTIONS VIX_VMPOWEROP_LAUNCH_GUI #define VMXPATH_INFO "where vmxpath is an absolute path to the .vmx file " \ "for the virtual machine." #else // USE_WORKSTATION /* * For VMware Server 2.0 */ #define CONNTYPE VIX_SERVICEPROVIDER_VMWARE_VI_SERVER #define HOSTNAME "https://192.2.3.4:8333/sdk" /* * NOTE: HOSTPORT is ignored, so the port should be specified as part * of the URL. */ #define HOSTPORT 0 #define USERNAME "root" #define PASSWORD "hideme" #define VMPOWEROPTIONS VIX_VMPOWEROP_NORMAL #define VMXPATH_INFO "where vmxpath is a datastore-relative path to the " \ ".vmx file for the virtual machine, such as " \ "\"[standard] ubuntu/ubuntu.vmx\"." #endif // USE_WORKSTATION #define TOOLS_TIMEOUT 300 #ifdef _WIN32 #define DEST_FILE ".\\outfile" #else #define DEST_FILE "./outfile.txt" #endif static char *progname; static void usage() { fprintf(stderr, "Usage: %s \n", progname); fprintf(stderr, "%s\n", VMXPATH_INFO); } int main(int argc, char **argv) { char *vmpath; VixError err; VixHandle hostHandle = VIX_INVALID_HANDLE; VixHandle jobHandle = VIX_INVALID_HANDLE; VixHandle vmHandle = VIX_INVALID_HANDLE; progname = argv[0]; if (argc > 1) { vmpath = argv[1]; } else { usage(); exit(EXIT_FAILURE); } jobHandle = VixHost_Connect(VIX_API_VERSION, // api version CONNTYPE, // connection type HOSTNAME, // host name HOSTPORT, // host port USERNAME, // username PASSWORD, // passwd 0, // options VIX_INVALID_HANDLE, // property list handle NULL, // callback NULL); // client data err = VixJob_Wait(jobHandle, VIX_PROPERTY_JOB_RESULT_HANDLE, &hostHandle, VIX_PROPERTY_NONE); Vix_ReleaseHandle(jobHandle); if (VIX_FAILED(err)) { fprintf(stderr, "failed to connect to host (%"FMT64"d %s)\n", err, Vix_GetErrorText(err, NULL)); goto abort; } printf("connected to host (%d)\n", hostHandle); printf ("about to open %s\n", vmpath); jobHandle = VixVM_Open(hostHandle, // host connection vmpath, // path to vmx NULL, // callback NULL); // client data err = VixJob_Wait(jobHandle, VIX_PROPERTY_JOB_RESULT_HANDLE, &vmHandle, VIX_PROPERTY_NONE); Vix_ReleaseHandle(jobHandle); if (VIX_FAILED(err)) { fprintf(stderr, "failed to open virtual machine '%s'(%"FMT64"d %s)\n", vmpath, err, Vix_GetErrorText(err, NULL)); goto abort; } printf ("opened %s (%d)\n", vmpath, vmHandle); printf("powering on\n"); jobHandle = VixVM_PowerOn(vmHandle, // vm handle VMPOWEROPTIONS, // options VIX_INVALID_HANDLE, // property list NULL, // callback NULL); // client data err = VixJob_Wait(jobHandle, VIX_PROPERTY_NONE); Vix_ReleaseHandle(jobHandle); if (VIX_FAILED(err)) { fprintf(stderr, "failed to power on virtual machine (%"FMT64"d %s)\n", err, Vix_GetErrorText(err, NULL)); goto abort; } printf("powered on\n"); printf("waiting for tools\n"); jobHandle = VixVM_WaitForToolsInGuest(vmHandle, TOOLS_TIMEOUT, // timeout in secs NULL, // callback NULL); // client data err = VixJob_Wait(jobHandle, VIX_PROPERTY_NONE); Vix_ReleaseHandle(jobHandle); if (VIX_FAILED(err)) { fprintf(stderr, "failed to wait for tools in virtual machine (%"FMT64"d %s)\n", err, Vix_GetErrorText(err, NULL)); goto abort; } printf("tools up\n"); jobHandle = VixVM_LoginInGuest(vmHandle, GUEST_USERNAME, // guest OS user GUEST_PASSWORD, // guest OS passwd 0, // options NULL, // callback NULL); // client data err = VixJob_Wait(jobHandle, VIX_PROPERTY_NONE); Vix_ReleaseHandle(jobHandle); if (VIX_FAILED(err)) { fprintf(stderr, "failed to login to virtual machine '%s'(%"FMT64"d %s)\n", vmpath, err, Vix_GetErrorText(err, NULL)); goto abort; } printf("logged in to guest\n"); printf("about to do work\n"); jobHandle = VixVM_RunProgramInGuest(vmHandle, "/bin/ls", // command " /bin > /tmp/outfile", // cmd args 0, // options VIX_INVALID_HANDLE, // prop handle NULL, // callback NULL); // client data err = VixJob_Wait(jobHandle, VIX_PROPERTY_NONE); Vix_ReleaseHandle(jobHandle); if (VIX_FAILED(err)) { fprintf(stderr, "failed to run program in virtual machine '%s'(%"FMT64"d %s)\n", vmpath, err, Vix_GetErrorText(err, NULL)); goto abort; } jobHandle = VixVM_CopyFileFromGuestToHost(vmHandle, "/tmp/outfile", // src file DEST_FILE, // dst file 0, // options VIX_INVALID_HANDLE, // prop list NULL, // callback NULL); // client data err = VixJob_Wait(jobHandle, VIX_PROPERTY_NONE); Vix_ReleaseHandle(jobHandle); if (VIX_FAILED(err)) { fprintf(stderr, "failed to copy file to the host '%s'(%"FMT64"d %s)\n", vmpath, err, Vix_GetErrorText(err, NULL)); goto abort; } jobHandle = VixVM_DeleteFileInGuest(vmHandle, "/tmp/outfile", // filepath NULL, // callback NULL); // client data err = VixJob_Wait(jobHandle, VIX_PROPERTY_NONE); Vix_ReleaseHandle(jobHandle); if (VIX_FAILED(err)) { fprintf(stderr, "failed to delete file in virtual machine '%s'(%"FMT64"d %s)\n", vmpath, err, Vix_GetErrorText(err, NULL)); goto abort; } abort: Vix_ReleaseHandle(vmHandle); VixHost_Disconnect(hostHandle); return 0; }