GuestSessionImpl.cpp revision ac5279f2dfaee3605ede93c424a1e35338f6655f
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync * VirtualBox Main - Guest session handling.
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync * Copyright (C) 2012-2013 Oracle Corporation
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync * available from http://www.virtualbox.org. This file is free software;
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync * you can redistribute it and/or modify it under the terms of the GNU
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync * General Public License (GPL) as published by the Free Software
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync/*******************************************************************************
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync* Header Files *
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync*******************************************************************************/
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync * Base class representing an internal
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync * asynchronous session task.
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync virtual ~GuestSessionTaskInternal(void) { }
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync const ComObjPtr<GuestSession> &Session(void) const { return mSession; }
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync * Class for asynchronously opening a guest session.
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsyncclass GuestSessionTaskInternalOpen : public GuestSessionTaskInternal
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync GuestSessionTaskInternalOpen(GuestSession *pSession)
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync * Internal listener class to serve events in an
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync * active manner, e.g. without polling delays.
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync STDMETHOD(HandleEvent)(VBoxEventType_T aType, IEvent *aEvent)
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync int rc2 = mSession->signalWaitEvents(aType, aEvent);
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync LogFlowFunc(("Signalling events of type=%ld, session=%p resulted in rc=%Rrc\n",
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsynctypedef ListenerImpl<GuestSessionListener, GuestSession*> GuestSessionListenerImpl;
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync// constructor / destructor
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync/////////////////////////////////////////////////////////////////////////////
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync// public initializer/uninitializer for internal purposes only
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync/////////////////////////////////////////////////////////////////////////////
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync * Initializes a guest session but does *not* open in on the guest side
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync * yet. This needs to be done via the openSession() / openSessionAsync calls.
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync * @return IPRT status code.
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync ** @todo Docs!
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsyncint GuestSession::init(Guest *pGuest, const GuestSessionStartupInfo &ssInfo,
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync LogFlowThisFunc(("pGuest=%p, ssInfo=%p, guestCreds=%p\n",
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync /* Enclose the state transition NotReady->InInit->Ready. */
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync AssertReturn(autoInitSpan.isOk(), VERR_OBJECT_DESTROYED);
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync /* Copy over startup info. */
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync /** @todo Use an overloaded copy operator. Later. */
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync mData.mSession.mOpenTimeoutMS = ssInfo.mOpenTimeoutMS;
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync /** @todo Use an overloaded copy operator. Later. */
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync mData.mCredentials.mPassword = guestCreds.mPassword;
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync hr = mEventSource->init(static_cast<IGuestSession*>(this));
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync GuestSessionListener *pListener = new GuestSessionListener();
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync eventTypes.push_back(VBoxEventType_OnGuestSessionStateChanged);
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync /* Confirm a successful initialization when it's the case. */
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync LogFlowThisFunc(("mName=%s, mID=%RU32, mIsInternal=%RTbool, rc=%Rrc\n",
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync mData.mSession.mName.c_str(), mData.mSession.mID, mData.mSession.mIsInternal, rc));
fb41ad77bcfbdb3aaa1fc9503a37ee6a70dc6461vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync * Uninitializes the instance.
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync * Called from FinalRelease().
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync /* Enclose the state transition Ready->InUninit->NotReady. */
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsync LogFlowThisFunc(("Closing directories (%RU64 total)\n",
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync for (SessionDirectories::iterator itDirs = mData.mDirectories.begin();
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync for (SessionFiles::iterator itFiles = mData.mFiles.begin();
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsync LogFlowThisFunc(("Closing processes (%RU64 total)\n",
ed9d3db07648c7e3a979105c15ad752ee9ea18devboxsync for (SessionProcesses::iterator itProcs = mData.mProcesses.begin();
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsync LogFlowThisFunc(("mNumObjects=%RU32\n", mData.mNumObjects));
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync// implementation of public getters/setters for attributes
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync/////////////////////////////////////////////////////////////////////////////
06ea6bcf23874b662d499b3f130024c98b2dd7a6vboxsyncSTDMETHODIMP GuestSession::COMGETTER(User)(BSTR *aUser)
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
06ea6bcf23874b662d499b3f130024c98b2dd7a6vboxsyncSTDMETHODIMP GuestSession::COMGETTER(Domain)(BSTR *aDomain)
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
06ea6bcf23874b662d499b3f130024c98b2dd7a6vboxsyncSTDMETHODIMP GuestSession::COMGETTER(Name)(BSTR *aName)
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::COMGETTER(Id)(ULONG *aId)
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsyncSTDMETHODIMP GuestSession::COMGETTER(Status)(GuestSessionStatus_T *aStatus)
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::COMGETTER(Timeout)(ULONG *aTimeout)
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
7e8ef90d3160234df0f254131b87af4243d79476vboxsyncSTDMETHODIMP GuestSession::COMSETTER(Timeout)(ULONG aTimeout)
7e8ef90d3160234df0f254131b87af4243d79476vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
7e8ef90d3160234df0f254131b87af4243d79476vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
cd5df721f068659172f3bf95de8fedeb465f057dvboxsyncSTDMETHODIMP GuestSession::COMGETTER(ProtocolVersion)(ULONG *aVersion)
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
06ea6bcf23874b662d499b3f130024c98b2dd7a6vboxsyncSTDMETHODIMP GuestSession::COMGETTER(Environment)(ComSafeArrayOut(BSTR, aEnvironment))
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync environment.detachTo(ComSafeArrayOutArg(aEnvironment));
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
1cd59fdf671ca60c64d77e3f7046aaecf7003824vboxsyncSTDMETHODIMP GuestSession::COMSETTER(Environment)(ComSafeArrayIn(IN_BSTR, aValues))
1cd59fdf671ca60c64d77e3f7046aaecf7003824vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
1cd59fdf671ca60c64d77e3f7046aaecf7003824vboxsync com::SafeArray<IN_BSTR> environment(ComSafeArrayInArg(aValues));
1cd59fdf671ca60c64d77e3f7046aaecf7003824vboxsync for (size_t i = 0; i < environment.size() && RT_SUCCESS(rc); i++)
1cd59fdf671ca60c64d77e3f7046aaecf7003824vboxsync if (!strEnv.isEmpty()) /* Silently skip empty entries. */
1cd59fdf671ca60c64d77e3f7046aaecf7003824vboxsync HRESULT hr = RT_SUCCESS(rc) ? S_OK : VBOX_E_IPRT_ERROR;
1cd59fdf671ca60c64d77e3f7046aaecf7003824vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::COMGETTER(Processes)(ComSafeArrayOut(IGuestProcess *, aProcesses))
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync SafeIfaceArray<IGuestProcess> collection(mData.mProcesses);
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync collection.detachTo(ComSafeArrayOutArg(aProcesses));
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync LogFlowFunc(("mProcesses=%zu\n", collection.size()));
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::COMGETTER(Directories)(ComSafeArrayOut(IGuestDirectory *, aDirectories))
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync SafeIfaceArray<IGuestDirectory> collection(mData.mDirectories);
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync collection.detachTo(ComSafeArrayOutArg(aDirectories));
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync LogFlowFunc(("mDirectories=%zu\n", collection.size()));
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::COMGETTER(Files)(ComSafeArrayOut(IGuestFile *, aFiles))
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync SafeIfaceArray<IGuestFile> collection(mData.mFiles);
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsyncSTDMETHODIMP GuestSession::COMGETTER(EventSource)(IEventSource ** aEventSource)
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync // no need to lock - lifetime constant
fb41ad77bcfbdb3aaa1fc9503a37ee6a70dc6461vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync// private methods
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync///////////////////////////////////////////////////////////////////////////////
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsyncint GuestSession::closeSession(uint32_t uFlags, uint32_t uTimeoutMS, int *pGuestRc)
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync LogFlowThisFunc(("uFlags=%x, uTimeoutMS=%RU32\n", uFlags, uTimeoutMS));
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync /* Guest Additions < 4.3 don't support closing dedicated
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync guest sessions, skip. */
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync LogFlowThisFunc(("Installed Guest Additions don't support closing dedicated sessions, skipping\n"));
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync /** @todo uFlags validation. */
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync LogFlowThisFunc(("Session ID=%RU32 not started (anymore), status now is: %ld\n",
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync eventTypes.push_back(VBoxEventType_OnGuestSessionStateChanged);
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync vrc = registerWaitEvent(mData.mSession.mID, 0 /* Object ID */,
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync LogFlowThisFunc(("Sending closing request to guest session ID=%RU32, uFlags=%x\n",
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync alock.release(); /* Drop the write lock before waiting. */
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync vrc = waitForStatusChange(pEvent, GuestSessionWaitForFlag_Terminate, uTimeoutMS,
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsyncint GuestSession::directoryRemoveFromList(GuestDirectory *pDirectory)
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync for (SessionDirectories::iterator itDirs = mData.mDirectories.begin();
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsync HRESULT hr = (*itDirs)->COMGETTER(DirectoryName)(strName.asOutParam());
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsync LogFlowFunc(("Removing directory \"%s\" (Session: %RU32) (now total %ld directories)\n",
5f2b03bf7695dabd71222dba123532a3f76828c1vboxsync Utf8Str(strName).c_str(), mData.mSession.mID, mData.mDirectories.size() - 1));
b8bb9c9f6b8ebfd0a7d6df0c0289f9fe80241750vboxsyncint GuestSession::directoryCreateInternal(const Utf8Str &strPath, uint32_t uMode, uint32_t uFlags, int *pGuestRc)
35e6d303696e46d969aaf9a59cc381333a483b0bvboxsync /* pGuestRc is optional. */
35e6d303696e46d969aaf9a59cc381333a483b0bvboxsync LogFlowThisFunc(("strPath=%s, uMode=%x, uFlags=%x\n",
35e6d303696e46d969aaf9a59cc381333a483b0bvboxsync procInfo.mCommand = Utf8Str(VBOXSERVICE_TOOL_MKDIR);
35e6d303696e46d969aaf9a59cc381333a483b0bvboxsync /* Construct arguments. */
35e6d303696e46d969aaf9a59cc381333a483b0bvboxsync procInfo.mArguments.push_back(Utf8Str("--parents")); /* We also want to create the parent directories. */
35e6d303696e46d969aaf9a59cc381333a483b0bvboxsync procInfo.mArguments.push_back(Utf8Str("--mode")); /* Set the creation mode. */
35e6d303696e46d969aaf9a59cc381333a483b0bvboxsync if (RTStrPrintf(szMode, sizeof(szMode), "%o", uMode))
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync procInfo.mArguments.push_back(strPath); /* The directory we want to create. */
35e6d303696e46d969aaf9a59cc381333a483b0bvboxsync vrc = procTool.Init(this, procInfo, false /* Async */, &guestRc);
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync vrc = procTool.Wait(GUESTPROCESSTOOL_FLAG_NONE, &guestRc);
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync guestRc = procTool.TerminatedOk(NULL /* Exit code */);
4121d226ac899f17e13aff3aff42b603c8b5c1fevboxsyncint GuestSession::directoryQueryInfoInternal(const Utf8Str &strPath, GuestFsObjData &objData, int *pGuestRc)
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync LogFlowThisFunc(("strPath=%s\n", strPath.c_str()));
4121d226ac899f17e13aff3aff42b603c8b5c1fevboxsync int vrc = fsQueryInfoInternal(strPath, objData, pGuestRc);
ca3db470494a8b6eaec69ea37468a5cda65e2da8vboxsyncint GuestSession::objectCreateTempInternal(const Utf8Str &strTemplate, const Utf8Str &strPath,
ca3db470494a8b6eaec69ea37468a5cda65e2da8vboxsync bool fDirectory, const Utf8Str &strName, int *pGuestRc)
ca3db470494a8b6eaec69ea37468a5cda65e2da8vboxsync procInfo.mCommand = Utf8Str(VBOXSERVICE_TOOL_MKTEMP);
ca3db470494a8b6eaec69ea37468a5cda65e2da8vboxsync procInfo.mArguments.push_back(Utf8Str("--machinereadable"));
ca3db470494a8b6eaec69ea37468a5cda65e2da8vboxsync if (strPath.length()) /* Otherwise use /tmp or equivalent. */
ca3db470494a8b6eaec69ea37468a5cda65e2da8vboxsync int vrc = procTool.Init(this, procInfo, false /* Async */, &guestRc);
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync vrc = procTool.Wait(GUESTPROCESSTOOL_FLAG_NONE, &guestRc);
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync guestRc = procTool.TerminatedOk(NULL /* Exit code */);
8bc8d66f188d5357155b8340e2d489573be2b607vboxsyncint GuestSession::directoryOpenInternal(const Utf8Str &strPath, const Utf8Str &strFilter,
8bc8d66f188d5357155b8340e2d489573be2b607vboxsync uint32_t uFlags, ComObjPtr<GuestDirectory> &pDirectory)
8bc8d66f188d5357155b8340e2d489573be2b607vboxsync LogFlowThisFunc(("strPath=%s, strPath=%s, uFlags=%x\n",
88cc9bf61296bc5526344415167bb2625ae1dd99vboxsync /* Create the directory object. */
8bc8d66f188d5357155b8340e2d489573be2b607vboxsync /* Add the created directory to our vector. */
8bc8d66f188d5357155b8340e2d489573be2b607vboxsync LogFlowFunc(("Added new directory \"%s\" (Session: %RU32)\n",
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsyncint GuestSession::dispatchToFile(PVBOXGUESTCTRLHOSTCBCTX pCtxCb, PVBOXGUESTCTRLHOSTCALLBACK pSvcCb)
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync LogFlowFunc(("pCtxCb=%p, pSvcCb=%p\n", pCtxCb, pSvcCb));
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync uint32_t uFileID = VBOX_GUESTCTRL_CONTEXTID_GET_OBJECT(pCtxCb->uContextID);
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsyncint GuestSession::dispatchToProcess(PVBOXGUESTCTRLHOSTCBCTX pCtxCb, PVBOXGUESTCTRLHOSTCALLBACK pSvcCb)
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync LogFlowFunc(("pCtxCb=%p, pSvcCb=%p\n", pCtxCb, pSvcCb));
cc1ef2ef9bbc6a0ff964928d61b7298e5bfcce5fvboxsync uint32_t uProcessID = VBOX_GUESTCTRL_CONTEXTID_GET_OBJECT(pCtxCb->uContextID);
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync /* Set protocol version so that pSvcCb can
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync * be interpreted right. */
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsyncint GuestSession::dispatchToThis(PVBOXGUESTCTRLHOSTCBCTX pCbCtx, PVBOXGUESTCTRLHOSTCALLBACK pSvcCb)
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync LogFlowThisFunc(("sessionID=%RU32, CID=%RU32, uFunction=%RU32, pSvcCb=%p\n",
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync mData.mSession.mID, pCbCtx->uContextID, pCbCtx->uFunction, pSvcCb));
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync /** @todo Handle closing all guest objects. */
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync /* Silently skip unknown callbacks. */
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsyncinline bool GuestSession::fileExists(uint32_t uFileID, ComObjPtr<GuestFile> *pFile)
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync SessionFiles::const_iterator it = mData.mFiles.find(uFileID);
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync return true;
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync return false;
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsyncint GuestSession::fileRemoveFromList(GuestFile *pFile)
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync for (SessionFiles::iterator itFiles = mData.mFiles.begin();
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync /* Make sure to consume the pointer before the one of thfe
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsync * iterator gets released. */
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsync HRESULT hr = pCurFile->COMGETTER(FileName)(strName.asOutParam());
5f2b03bf7695dabd71222dba123532a3f76828c1vboxsync LogFlowThisFunc(("Removing guest file \"%s\" (Session: %RU32) (now total %ld files, %ld objects)\n",
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsync Utf8Str(strName).c_str(), mData.mSession.mID, mData.mFiles.size() - 1, mData.mNumObjects - 1));
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync alock.release(); /* Release lock before firing off event. */
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync fireGuestFileRegisteredEvent(mEventSource, this, pCurFile,
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync false /* Unregistered */);
004d74842597dacc4009803171296dfcf9398c69vboxsyncint GuestSession::fileRemoveInternal(const Utf8Str &strPath, int *pGuestRc)
004d74842597dacc4009803171296dfcf9398c69vboxsync procInfo.mArguments.push_back(Utf8Str("--machinereadable"));
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync procInfo.mArguments.push_back(strPath); /* The file we want to remove. */
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync int vrc = procTool.Init(this, procInfo, false /* Async */, &guestRc);
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync vrc = procTool.Wait(GUESTPROCESSTOOL_FLAG_NONE, &guestRc);
b8bb9c9f6b8ebfd0a7d6df0c0289f9fe80241750vboxsync guestRc = procTool.TerminatedOk(NULL /* Exit code */);
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsyncint GuestSession::fileOpenInternal(const GuestFileOpenInfo &openInfo, ComObjPtr<GuestFile> &pFile, int *pGuestRc)
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync LogFlowThisFunc(("strPath=%s, strOpenMode=%s, strDisposition=%s, uCreationMode=%x, iOffset=%RI64\n",
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync openInfo.mFileName.c_str(), openInfo.mOpenMode.c_str(), openInfo.mDisposition.c_str(),
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync if (mData.mNumObjects >= VBOX_GUESTCTRL_MAX_OBJECTS)
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync /* Create a new (host-based) file ID and assign it. */
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync /* Is the file ID already used? */
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync /* Callback with context ID was not found. This means
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync * we can use this context ID for our new callback we want
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync * to add below. */
88cc9bf61296bc5526344415167bb2625ae1dd99vboxsync break; /* Don't try too hard. */
5366e994777f9d9391cf809dc77610f57270d75dvboxsync /* Create the directory object. */
d8e12fa5dd1c35282b98cb165e42b6b395cf971bvboxsync rc = pFile->init(pConsole, this /* GuestSession */,
15c6c4ce0082362b8b81e15c3605f2d3aca69a21vboxsync /* Add the created file to our vector. */
d8e12fa5dd1c35282b98cb165e42b6b395cf971bvboxsync Assert(mData.mNumObjects <= VBOX_GUESTCTRL_MAX_OBJECTS);
d8e12fa5dd1c35282b98cb165e42b6b395cf971bvboxsync LogFlowFunc(("Added new guest file \"%s\" (Session: %RU32) (now total %ld files, %ld objects)\n",
d8e12fa5dd1c35282b98cb165e42b6b395cf971bvboxsync openInfo.mFileName.c_str(), mData.mSession.mID, mData.mFiles.size(), mData.mNumObjects));
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync alock.release(); /* Release lock before firing off event. */
5366e994777f9d9391cf809dc77610f57270d75dvboxsync fireGuestFileRegisteredEvent(mEventSource, this, pFile,
5366e994777f9d9391cf809dc77610f57270d75dvboxsync true /* Registered */);
4121d226ac899f17e13aff3aff42b603c8b5c1fevboxsyncint GuestSession::fileQueryInfoInternal(const Utf8Str &strPath, GuestFsObjData &objData, int *pGuestRc)
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync LogFlowThisFunc(("strPath=%s\n", strPath.c_str()));
4121d226ac899f17e13aff3aff42b603c8b5c1fevboxsync int vrc = fsQueryInfoInternal(strPath, objData, pGuestRc);
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsyncint GuestSession::fileQuerySizeInternal(const Utf8Str &strPath, int64_t *pllSize, int *pGuestRc)
4121d226ac899f17e13aff3aff42b603c8b5c1fevboxsync int vrc = fileQueryInfoInternal(strPath, objData, pGuestRc);
e378dfdadd62aadc0a012c9953322d979d7606e6vboxsyncint GuestSession::fsQueryInfoInternal(const Utf8Str &strPath, GuestFsObjData &objData, int *pGuestRc)
e378dfdadd62aadc0a012c9953322d979d7606e6vboxsync LogFlowThisFunc(("strPath=%s\n", strPath.c_str()));
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync /** @todo Merge this with IGuestFile::queryInfo(). */
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync procInfo.mCommand = Utf8Str(VBOXSERVICE_TOOL_STAT);
e378dfdadd62aadc0a012c9953322d979d7606e6vboxsync /* Construct arguments. */
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync procInfo.mArguments.push_back(Utf8Str("--machinereadable"));
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync int vrc = procTool.Init(this, procInfo, false /* Async */, &guestRc);
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync vrc = procTool.Wait(GUESTPROCESSTOOL_FLAG_NONE, &guestRc);
e378dfdadd62aadc0a012c9953322d979d7606e6vboxsync guestRc = procTool.TerminatedOk(NULL /* Exit code */);
b8bb9c9f6b8ebfd0a7d6df0c0289f9fe80241750vboxsync vrc = procTool.GetCurrentBlock(OUTPUT_HANDLE_ID_STDOUT, curBlock);
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync /** @todo Check for more / validate blocks! */
7862f4bd000f1eb6c86289f5ac2849e9cf943ca9vboxsyncconst GuestCredentials& GuestSession::getCredentials(void)
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsyncconst GuestEnvironment& GuestSession::getEnvironment(void)
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync/* static */
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsyncUtf8Str GuestSession::guestErrorToString(int guestRc)
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync /** @todo pData->u32Flags: int vs. uint32 -- IPRT errors are *negative* !!! */
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync strError += Utf8StrFmt(tr("VMM device is not available (is the VM running?)"));
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync strError += Utf8StrFmt(tr("The guest execution service is not available"));
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync strError += Utf8StrFmt(tr("The specified user was not able to logon on guest"));
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync strError += Utf8StrFmt(tr("The guest did not respond within time"));
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync strError += Utf8StrFmt(tr("The session operation was canceled"));
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync strError += Utf8StrFmt(tr("Invalid user/password credentials"));
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync strError += Utf8StrFmt(tr("Maximum number of concurrent guest processes has been reached"));
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync case VERR_NOT_EQUAL: /** @todo Imprecise to the user; can mean anything and all. */
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync strError += Utf8StrFmt(tr("Unable to retrieve requested information"));
40c1a23e86c79b24a917a43c186b2e54504d12c1vboxsync strError += Utf8StrFmt(tr("The guest execution service is not ready (yet)"));
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync * Checks if this session is ready state where it can handle
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync * all session-bound actions (like guest processes, guest files).
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync * Only used by official API methods. Will set an external
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync * error when not ready.
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync /** @todo Be a bit more informative. */
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync return setError(E_UNEXPECTED, tr("Session is not in started state"));
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync/** No locking! */
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsyncint GuestSession::onSessionStatusChange(PVBOXGUESTCTRLHOSTCBCTX pCbCtx, PVBOXGUESTCTRLHOSTCALLBACK pSvcCbData)
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync /* pCallback is optional. */
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync /* pSvcCb->mpaParms[0] always contains the context ID. */
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync pSvcCbData->mpaParms[2].getUInt32(&dataCb.uResult);
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync LogFlowThisFunc(("ID=%RU32, uType=%RU32, guestRc=%Rrc\n",
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync mData.mSession.mID, dataCb.uType, dataCb.uResult));
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync GuestSessionStatus_T sessionStatus = GuestSessionStatus_Undefined;
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync int guestRc = dataCb.uResult; /** @todo uint32_t vs. int. */
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync sessionStatus = GuestSessionStatus_TimedOutAbnormally;
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync /* Set the session status. */
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync LogFlowThisFunc(("ID=%RU32, guestRc=%Rrc\n", mData.mSession.mID, guestRc));
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsyncint GuestSession::startSessionInternal(int *pGuestRc)
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync LogFlowThisFunc(("mID=%RU32, mName=%s, uProtocolVersion=%RU32, openFlags=%x, openTimeoutMS=%RU32\n",
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync mData.mSession.mID, mData.mSession.mName.c_str(), mData.mProtocolVersion,
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync mData.mSession.mOpenFlags, mData.mSession.mOpenTimeoutMS));
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync /* Guest Additions < 4.3 don't support opening dedicated
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync guest sessions. Simply return success here. */
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync LogFlowThisFunc(("Installed Guest Additions don't support opening dedicated sessions, skipping\n"));
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync /** @todo mData.mSession.uFlags validation. */
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync /* Set current session status. */
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync eventTypes.push_back(VBoxEventType_OnGuestSessionStateChanged);
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync vrc = registerWaitEvent(mData.mSession.mID, 0 /* Object ID */,
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync paParms[i++].setPointer((void*)mData.mCredentials.mUser.c_str(),
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync paParms[i++].setPointer((void*)mData.mCredentials.mPassword.c_str(),
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync paParms[i++].setPointer((void*)mData.mCredentials.mDomain.c_str(),
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync alock.release(); /* Drop write lock before sending. */
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync vrc = sendCommand(HOST_SESSION_CREATE, i, paParms);
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync vrc = waitForStatusChange(pEvent, GuestSessionWaitForFlag_Start,
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync /* Asynchronously open the session on the guest by kicking off a
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync * worker thread. */
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync std::auto_ptr<GuestSessionTaskInternalOpen> pTask(new GuestSessionTaskInternalOpen(this));
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync vrc = RTThreadCreate(NULL, GuestSession::startSessionThread,
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync "gctlSesStart");
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync /* pTask is now owned by openSessionThread(), so release it. */
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync/* static */
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsyncDECLCALLBACK(int) GuestSession::startSessionThread(RTTHREAD Thread, void *pvUser)
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync std::auto_ptr<GuestSessionTaskInternalOpen> pTask(static_cast<GuestSessionTaskInternalOpen*>(pvUser));
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync const ComObjPtr<GuestSession> pSession(pTask->Session());
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync int vrc = pSession->startSessionInternal(NULL /* Guest rc, ignored */);
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync /* Nothing to do here anymore. */
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsyncint GuestSession::processRemoveFromList(GuestProcess *pProcess)
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync LogFlowFunc(("Closing process (PID=%RU32) ...\n", uPID));
5f2b03bf7695dabd71222dba123532a3f76828c1vboxsync SessionProcesses::iterator itProcs = mData.mProcesses.begin();
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsync /* Make sure to consume the pointer before the one of thfe
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsync * iterator gets released. */
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync LogFlowFunc(("Removing process ID=%RU32 (Session: %RU32), guest PID=%RU32 (now total %ld processes, %ld objects)\n",
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync pProcess->getObjectID(), mData.mSession.mID, uPID, mData.mProcesses.size() - 1, mData.mNumObjects - 1));
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsync alock.release(); /* Release lock before firing off event. */
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync fireGuestProcessRegisteredEvent(mEventSource, this /* Session */, pCurProcess,
5366e994777f9d9391cf809dc77610f57270d75dvboxsync * Creates but does *not* start the process yet. See GuestProcess::startProcess() or
5366e994777f9d9391cf809dc77610f57270d75dvboxsync * GuestProcess::startProcessAsync() for that.
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync * @return IPRT status code.
cc1ef2ef9bbc6a0ff964928d61b7298e5bfcce5fvboxsync * @param procInfo
cc1ef2ef9bbc6a0ff964928d61b7298e5bfcce5fvboxsync * @param pProcess
5366e994777f9d9391cf809dc77610f57270d75dvboxsyncint GuestSession::processCreateExInteral(GuestProcessStartupInfo &procInfo, ComObjPtr<GuestProcess> &pProcess)
5366e994777f9d9391cf809dc77610f57270d75dvboxsync LogFlowFunc(("mCmd=%s, mFlags=%x, mTimeoutMS=%RU32\n",
5366e994777f9d9391cf809dc77610f57270d75dvboxsync procInfo.mCommand.c_str(), procInfo.mFlags, procInfo.mTimeoutMS));
5366e994777f9d9391cf809dc77610f57270d75dvboxsync ProcessArguments::const_iterator it = procInfo.mArguments.begin();
ed9d3db07648c7e3a979105c15ad752ee9ea18devboxsync /* Validate flags. */
7e8ef90d3160234df0f254131b87af4243d79476vboxsync if ( !(procInfo.mFlags & ProcessCreateFlag_IgnoreOrphanedProcesses)
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync && !(procInfo.mFlags & ProcessCreateFlag_WaitForProcessStartOnly)
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync && !(procInfo.mFlags & ProcessCreateFlag_NoProfile)
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync && !(procInfo.mFlags & ProcessCreateFlag_WaitForStdOut)
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync && !(procInfo.mFlags & ProcessCreateFlag_WaitForStdErr))
e2489bd9ef063ae006feaebc3318ffa4143f6e16vboxsync if ( (procInfo.mFlags & ProcessCreateFlag_WaitForProcessStartOnly)
e2489bd9ef063ae006feaebc3318ffa4143f6e16vboxsync && ( (procInfo.mFlags & ProcessCreateFlag_WaitForStdOut)
e2489bd9ef063ae006feaebc3318ffa4143f6e16vboxsync || (procInfo.mFlags & ProcessCreateFlag_WaitForStdErr)
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync /* Adjust timeout. If set to 0, we define
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync * an infinite timeout. */
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsync /** @tood Implement process priority + affinity. */
687794577e2e35c3cae67e692a7f2130d1262a82vboxsync if (mData.mNumObjects >= VBOX_GUESTCTRL_MAX_OBJECTS)
5f2b03bf7695dabd71222dba123532a3f76828c1vboxsync /* Create a new (host-based) process ID and assign it. */
5f2b03bf7695dabd71222dba123532a3f76828c1vboxsync /* Is the context ID already used? */
5f2b03bf7695dabd71222dba123532a3f76828c1vboxsync if (!processExists(uNewProcessID, NULL /* pProgress */))
5f2b03bf7695dabd71222dba123532a3f76828c1vboxsync /* Callback with context ID was not found. This means
6b9d50a0f466bd5a61458ed53925480ab28a3c17vboxsync * we can use this context ID for our new callback we want
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsync * to add below. */
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync break; /* Don't try too hard. */
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync /* Create the process object. */
88cc9bf61296bc5526344415167bb2625ae1dd99vboxsync rc = pProcess->init(mParent->getConsole() /* Console */, this /* Session */,
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync /* Add the created process to our map. */
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsync Assert(mData.mNumObjects <= VBOX_GUESTCTRL_MAX_OBJECTS);
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync fireGuestProcessRegisteredEvent(mEventSource, this /* Session */, pProcess,
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync LogFlowFunc(("Added new process (Session: %RU32) with process ID=%RU32 (now total %ld processes, %ld objects)\n",
ccbdc11833996cb9f3be7868f1ebaefcacafb94dvboxsync mData.mSession.mID, uNewProcessID, mData.mProcesses.size(), mData.mNumObjects));
687794577e2e35c3cae67e692a7f2130d1262a82vboxsyncinline bool GuestSession::processExists(uint32_t uProcessID, ComObjPtr<GuestProcess> *pProcess)
687794577e2e35c3cae67e692a7f2130d1262a82vboxsync SessionProcesses::const_iterator it = mData.mProcesses.find(uProcessID);
687794577e2e35c3cae67e692a7f2130d1262a82vboxsync return true;
687794577e2e35c3cae67e692a7f2130d1262a82vboxsync return false;
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsyncinline int GuestSession::processGetByPID(ULONG uPID, ComObjPtr<GuestProcess> *pProcess)
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsync /* pProcess is optional. */
687794577e2e35c3cae67e692a7f2130d1262a82vboxsync SessionProcesses::iterator itProcs = mData.mProcesses.begin();
687794577e2e35c3cae67e692a7f2130d1262a82vboxsync for (; itProcs != mData.mProcesses.end(); itProcs++)
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsync ComObjPtr<GuestProcess> pCurProc = itProcs->second;
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync ComObjPtr<Console> pConsole = mParent->getConsole();
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync /* Forward the information to the VMM device. */
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync LogFlowThisFunc(("uFunction=%RU32, uParms=%RU32\n", uFunction, uParms));
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync int vrc = pVMMDev->hgcmHostCall(HGCMSERVICE_NAME, uFunction, uParms, paParms);
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync /** @todo What to do here? */
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync /* Not needed within testcases. */
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync/* static */
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsyncHRESULT GuestSession::setErrorExternal(VirtualBoxBase *pInterface, int guestRc)
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync AssertMsg(RT_FAILURE(guestRc), ("Guest rc does not indicate a failure when setting error\n"));
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync return pInterface->setError(VBOX_E_IPRT_ERROR, GuestSession::guestErrorToString(guestRc).c_str());
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync/* Does not do locking; caller is responsible for that! */
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsyncint GuestSession::setSessionStatus(GuestSessionStatus_T sessionStatus, int sessionRc)
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync LogFlowThisFunc(("oldStatus=%ld, newStatus=%ld, sessionRc=%Rrc\n",
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync AssertMsg(RT_FAILURE(sessionRc), ("Guest rc must be an error (%Rrc)\n", sessionRc));
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync /* Do not allow overwriting an already set error. If this happens
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync * this means we forgot some error checking/locking somewhere. */
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync AssertMsg(RT_SUCCESS(mData.mRC), ("Guest rc already set (to %Rrc)\n", mData.mRC));
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync AssertMsg(RT_SUCCESS(sessionRc), ("Guest rc must not be an error (%Rrc)\n", sessionRc));
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync int rc2 = errorInfo->initEx(VBOX_E_IPRT_ERROR, sessionRc,
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync fireGuestSessionStateChangedEvent(mEventSource, this,
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsyncint GuestSession::signalWaiters(GuestSessionWaitResult_T enmWaitResult, int rc /*= VINF_SUCCESS */)
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync /*LogFlowThisFunc(("enmWaitResult=%d, rc=%Rrc, mWaitCount=%RU32, mWaitEvent=%p\n",
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync enmWaitResult, rc, mData.mWaitCount, mData.mWaitEvent));*/
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync /* Note: No write locking here -- already done in the caller. */
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync /*if (mData.mWaitEvent)
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsync vrc = mData.mWaitEvent->Signal(enmWaitResult, rc);*/
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsyncint GuestSession::startTaskAsync(const Utf8Str &strTaskDesc,
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsync GuestSessionTask *pTask, ComObjPtr<Progress> &pProgress)
88cc9bf61296bc5526344415167bb2625ae1dd99vboxsync LogFlowThisFunc(("strTaskDesc=%s, pTask=%p\n", strTaskDesc.c_str(), pTask));
88cc9bf61296bc5526344415167bb2625ae1dd99vboxsync /* Create the progress object. */
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsync hr = pProgress->init(static_cast<IGuestSession*>(this),
88cc9bf61296bc5526344415167bb2625ae1dd99vboxsync /* Initialize our worker task. */
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsync /* Don't destruct on success. */
f9ce005e61f0fbb51a2cabc53d58c3485151faa9vboxsync * Queries/collects information prior to establishing a guest session.
f9ce005e61f0fbb51a2cabc53d58c3485151faa9vboxsync * This is necessary to know which guest control protocol version to use,
f9ce005e61f0fbb51a2cabc53d58c3485151faa9vboxsync * among other things (later).
f9ce005e61f0fbb51a2cabc53d58c3485151faa9vboxsync * @return IPRT status code.
f9ce005e61f0fbb51a2cabc53d58c3485151faa9vboxsync * Try querying the guest control protocol version running on the guest.
f9ce005e61f0fbb51a2cabc53d58c3485151faa9vboxsync * This is done using the Guest Additions version
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync uint32_t uVerAdditions = pGuest->getAdditionsVersion();
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync uint32_t uVBoxMajor = VBOX_FULL_VERSION_GET_MAJOR(uVerAdditions);
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync uint32_t uVBoxMinor = VBOX_FULL_VERSION_GET_MINOR(uVerAdditions);
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync /* Hardcode the to-used protocol version; nice for testing side effects. */
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync /* VBox 5.0 and up. */
f9ce005e61f0fbb51a2cabc53d58c3485151faa9vboxsync /* VBox 4.3 and up. */
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync /* Build revision is ignored. */
f9ce005e61f0fbb51a2cabc53d58c3485151faa9vboxsync LogFlowThisFunc(("uVerAdditions=%RU32 (%RU32.%RU32), mProtocolVersion=%RU32\n",
f9ce005e61f0fbb51a2cabc53d58c3485151faa9vboxsync uVerAdditions, uVBoxMajor, uVBoxMinor, mData.mProtocolVersion));
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync /* Tell the user but don't bitch too often. */
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync static short s_gctrlLegacyWarning = 0;
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync && s_gctrlLegacyWarning++ < 3) /** @todo Find a bit nicer text. */
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync LogRel((tr("Warning: Guest Additions are older (%ld.%ld) than host capabilities for guest control, please upgrade them. Using protocol version %ld now\n"),
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsyncint GuestSession::waitFor(uint32_t fWaitFlags, ULONG uTimeoutMS, GuestSessionWaitResult_T &waitResult, int *pGuestRc)
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync /*LogFlowThisFunc(("fWaitFlags=0x%x, uTimeoutMS=%RU32, mStatus=%RU32, mWaitCount=%RU32, mWaitEvent=%p, pGuestRc=%p\n",
b8bb9c9f6b8ebfd0a7d6df0c0289f9fe80241750vboxsync fWaitFlags, uTimeoutMS, mData.mStatus, mData.mWaitCount, mData.mWaitEvent, pGuestRc));*/
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync /* Did some error occur before? Then skip waiting and return. */
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync AssertMsg(RT_FAILURE(mData.mRC), ("No error rc (%Rrc) set when guest session indicated an error\n", mData.mRC));
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync *pGuestRc = mData.mRC; /* Return last set error. */
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync /* Guest Additions < 4.3 don't support session handling, skip. */
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync waitResult = GuestSessionWaitResult_WaitFlagNotSupported;
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync LogFlowThisFunc(("Installed Guest Additions don't support waiting for dedicated sessions, skipping\n"));
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync if (fWaitFlags & GuestSessionWaitForFlag_Terminate)
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync /* Handled above. */
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync /* Do the waiting below. */
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync AssertMsgFailed(("Unhandled session status %ld\n", mData.mStatus));
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync else if (fWaitFlags & GuestSessionWaitForFlag_Start)
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync /* Do the waiting below. */
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync AssertMsgFailed(("Unhandled session status %ld\n", mData.mStatus));
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync LogFlowThisFunc(("sessionStatus=%ld, sessionRc=%Rrc, waitResult=%ld\n",
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync /* No waiting needed? Return immediately using the last set error. */
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync *pGuestRc = mData.mRC; /* Return last set error (if any). */
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync return RT_SUCCESS(mData.mRC) ? VINF_SUCCESS : VERR_GSTCTL_GUEST_ERROR;
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync eventTypes.push_back(VBoxEventType_OnGuestSessionStateChanged);
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync vrc = registerWaitEvent(mData.mSession.mID, 0 /* Object ID */,
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync alock.release(); /* Release lock before waiting. */
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsyncint GuestSession::waitForStatusChange(GuestWaitEvent *pEvent, uint32_t fWaitFlags, uint32_t uTimeoutMS,
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync GuestSessionStatus_T *pSessionStatus, int *pGuestRc)
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync Assert(evtType == VBoxEventType_OnGuestSessionStateChanged);
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync ComPtr<IGuestSessionStateChangedEvent> pChangedEvent = pIEvent;
ecf100db90e8e3af96312908282d3c20e754fbe8vboxsync HRESULT hr = pChangedEvent->COMGETTER(Error)(errorInfo.asOutParam());
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync hr = errorInfo->COMGETTER(ResultDetail)(&lGuestRc);
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync LogFlowThisFunc(("Status changed event for session ID=%RU32, new status is: %ld (%Rrc)\n",
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync RT_SUCCESS((int)lGuestRc) ? VINF_SUCCESS : (int)lGuestRc));
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsync// implementation of public methods
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsync/////////////////////////////////////////////////////////////////////////////
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
c10a6f0c7041e4d1ee50ad38425aab9d43c55522vboxsync /* Close session on guest. */
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync int rc = closeSession(0 /* Flags */, 30 * 1000 /* Timeout */,
3fb3de312d1ff675e0f7cc62a7d46cbb1d5d9353vboxsync /* On failure don't return here, instead do all the cleanup
d8e12fa5dd1c35282b98cb165e42b6b395cf971bvboxsync * work first and then return an error. */
d8e12fa5dd1c35282b98cb165e42b6b395cf971bvboxsync /* Remove ourselves from the session list. */
d4a9d525e6f2111d462d2d96462dced6b9ec00efvboxsync LogFlowThisFunc(("Returning rc=%Rrc, guestRc=%Rrc\n",
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync return GuestSession::setErrorExternal(this, guestRc);
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsyncSTDMETHODIMP GuestSession::CopyFrom(IN_BSTR aSource, IN_BSTR aDest, ComSafeArrayIn(CopyFileFlag_T, aFlags), IProgress **aProgress)
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsync if (RT_UNLIKELY((aSource) == NULL || *(aSource) == '\0'))
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsync return setError(E_INVALIDARG, tr("No source specified"));
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsync if (RT_UNLIKELY((aDest) == NULL || *(aDest) == '\0'))
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsync return setError(E_INVALIDARG, tr("No destination specified"));
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
c99b597540585068d22dde4c9f74730305f24097vboxsync com::SafeArray<CopyFileFlag_T> flags(ComSafeArrayInArg(aFlags));
c99b597540585068d22dde4c9f74730305f24097vboxsync SessionTaskCopyFrom *pTask = new SessionTaskCopyFrom(this /* GuestSession */,
c99b597540585068d22dde4c9f74730305f24097vboxsync int rc = startTaskAsync(Utf8StrFmt(tr("Copying \"%ls\" from guest to \"%ls\" on the host"), aSource, aDest),
c99b597540585068d22dde4c9f74730305f24097vboxsync /* Return progress to the caller. */
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsync tr("Starting task for copying file \"%ls\" from guest to \"%ls\" on the host failed: %Rrc"), rc);
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsyncSTDMETHODIMP GuestSession::CopyTo(IN_BSTR aSource, IN_BSTR aDest, ComSafeArrayIn(CopyFileFlag_T, aFlags), IProgress **aProgress)
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsync if (RT_UNLIKELY((aSource) == NULL || *(aSource) == '\0'))
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsync return setError(E_INVALIDARG, tr("No source specified"));
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsync if (RT_UNLIKELY((aDest) == NULL || *(aDest) == '\0'))
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsync return setError(E_INVALIDARG, tr("No destination specified"));
0fd108a555ae02f2fb557d5f2c40281999b60d15vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
c99b597540585068d22dde4c9f74730305f24097vboxsync com::SafeArray<CopyFileFlag_T> flags(ComSafeArrayInArg(aFlags));
c99b597540585068d22dde4c9f74730305f24097vboxsync SessionTaskCopyTo *pTask = new SessionTaskCopyTo(this /* GuestSession */,
c99b597540585068d22dde4c9f74730305f24097vboxsync int rc = startTaskAsync(Utf8StrFmt(tr("Copying \"%ls\" from host to \"%ls\" on the guest"), aSource, aDest),
c99b597540585068d22dde4c9f74730305f24097vboxsync /* Return progress to the caller. */
35e6d303696e46d969aaf9a59cc381333a483b0bvboxsync tr("Starting task for copying file \"%ls\" from host to \"%ls\" on the guest failed: %Rrc"), rc);
35e6d303696e46d969aaf9a59cc381333a483b0bvboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::DirectoryCreate(IN_BSTR aPath, ULONG aMode,
35e6d303696e46d969aaf9a59cc381333a483b0bvboxsync if (RT_UNLIKELY((aPath) == NULL || *(aPath) == '\0'))
35e6d303696e46d969aaf9a59cc381333a483b0bvboxsync return setError(E_INVALIDARG, tr("No directory to create specified"));
5366e994777f9d9391cf809dc77610f57270d75dvboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
35e6d303696e46d969aaf9a59cc381333a483b0bvboxsync com::SafeArray<DirectoryCreateFlag_T> flags(ComSafeArrayInArg(aFlags));
35e6d303696e46d969aaf9a59cc381333a483b0bvboxsync return setError(E_INVALIDARG, tr("Unknown flags (%#x)"), fFlags);
35e6d303696e46d969aaf9a59cc381333a483b0bvboxsync ComObjPtr <GuestDirectory> pDirectory; int guestRc;
35e6d303696e46d969aaf9a59cc381333a483b0bvboxsync int rc = directoryCreateInternal(Utf8Str(aPath), (uint32_t)aMode, fFlags, &guestRc);
35e6d303696e46d969aaf9a59cc381333a483b0bvboxsync hr = GuestProcess::setErrorExternal(this, guestRc);
35e6d303696e46d969aaf9a59cc381333a483b0bvboxsync hr = setError(VBOX_E_IPRT_ERROR, tr("Directory creation failed: Invalid parameters given"));
35e6d303696e46d969aaf9a59cc381333a483b0bvboxsync hr = setError(VBOX_E_IPRT_ERROR, tr("Directory creation failed: Unexpectedly aborted"));
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync hr = setError(VBOX_E_IPRT_ERROR, tr("Directory creation failed: Could not create directory"));
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync hr = setError(VBOX_E_IPRT_ERROR, tr("Directory creation failed: %Rrc"), rc);
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsyncSTDMETHODIMP GuestSession::DirectoryCreateTemp(IN_BSTR aTemplate, ULONG aMode, IN_BSTR aPath, BOOL aSecure, BSTR *aDirectory)
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync if (RT_UNLIKELY((aTemplate) == NULL || *(aTemplate) == '\0'))
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync return setError(E_INVALIDARG, tr("No template specified"));
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync if (RT_UNLIKELY((aPath) == NULL || *(aPath) == '\0'))
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync return setError(E_INVALIDARG, tr("No directory name specified"));
36f3c24e4ad9c6b813767db1faeabbe7e2ecc057vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
b8bb9c9f6b8ebfd0a7d6df0c0289f9fe80241750vboxsync int rc = objectCreateTempInternal(Utf8Str(aTemplate),
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync hr = GuestProcess::setErrorExternal(this, guestRc);
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync hr = setError(VBOX_E_IPRT_ERROR, tr("Temporary directory creation \"%s\" with template \"%s\" failed: %Rrc"),
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync Utf8Str(aPath).c_str(), Utf8Str(aTemplate).c_str(), rc);
58c0567dee3cc3ebe62dec1e27f8e35bac4ddeb0vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::DirectoryExists(IN_BSTR aPath, BOOL *aExists)
58c0567dee3cc3ebe62dec1e27f8e35bac4ddeb0vboxsync if (RT_UNLIKELY((aPath) == NULL || *(aPath) == '\0'))
58c0567dee3cc3ebe62dec1e27f8e35bac4ddeb0vboxsync return setError(E_INVALIDARG, tr("No directory to check existence for specified"));
58c0567dee3cc3ebe62dec1e27f8e35bac4ddeb0vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync int rc = directoryQueryInfoInternal(Utf8Str(aPath), objData, &guestRc);
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync hr = GuestProcess::setErrorExternal(this, guestRc);
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync hr = setError(VBOX_E_IPRT_ERROR, tr("Querying directory existence \"%s\" failed: %Rrc"),
8bc8d66f188d5357155b8340e2d489573be2b607vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
8bc8d66f188d5357155b8340e2d489573be2b607vboxsyncSTDMETHODIMP GuestSession::DirectoryOpen(IN_BSTR aPath, IN_BSTR aFilter, ComSafeArrayIn(DirectoryOpenFlag_T, aFlags), IGuestDirectory **aDirectory)
8bc8d66f188d5357155b8340e2d489573be2b607vboxsync if (RT_UNLIKELY((aPath) == NULL || *(aPath) == '\0'))
8bc8d66f188d5357155b8340e2d489573be2b607vboxsync return setError(E_INVALIDARG, tr("No directory to open specified"));
8bc8d66f188d5357155b8340e2d489573be2b607vboxsync if (RT_UNLIKELY((aFilter) != NULL && *(aFilter) != '\0'))
8bc8d66f188d5357155b8340e2d489573be2b607vboxsync return setError(E_INVALIDARG, tr("Directory filters are not implemented yet"));
8bc8d66f188d5357155b8340e2d489573be2b607vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
8bc8d66f188d5357155b8340e2d489573be2b607vboxsync com::SafeArray<DirectoryOpenFlag_T> flags(ComSafeArrayInArg(aFlags));
8bc8d66f188d5357155b8340e2d489573be2b607vboxsync return setError(E_INVALIDARG, tr("Open flags (%#x) not implemented yet"), fFlags);
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync int rc = directoryOpenInternal(Utf8Str(aPath), Utf8Str(aFilter), fFlags, pDirectory);
8bc8d66f188d5357155b8340e2d489573be2b607vboxsync /* Return directory object to the caller. */
8bc8d66f188d5357155b8340e2d489573be2b607vboxsync hr = setError(VBOX_E_IPRT_ERROR, tr("Opening directory \"%s\" failed; invalid parameters given",
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync hr = setError(VBOX_E_IPRT_ERROR, tr("Opening directory \"%s\" failed: %Rrc"),
4121d226ac899f17e13aff3aff42b603c8b5c1fevboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::DirectoryQueryInfo(IN_BSTR aPath, IGuestFsObjInfo **aInfo)
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync if (RT_UNLIKELY((aPath) == NULL || *(aPath) == '\0'))
4121d226ac899f17e13aff3aff42b603c8b5c1fevboxsync return setError(E_INVALIDARG, tr("No directory to query information for specified"));
4121d226ac899f17e13aff3aff42b603c8b5c1fevboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync int vrc = directoryQueryInfoInternal(Utf8Str(aPath), objData, &guestRc);
4121d226ac899f17e13aff3aff42b603c8b5c1fevboxsync hr = GuestProcess::setErrorExternal(this, guestRc);
4121d226ac899f17e13aff3aff42b603c8b5c1fevboxsync hr = setError(VBOX_E_IPRT_ERROR, tr("Element \"%s\" exists but is not a directory",
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync hr = setError(VBOX_E_IPRT_ERROR, tr("Querying directory information for \"%s\" failed: %Rrc"),
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::DirectoryRemove(IN_BSTR aPath)
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::DirectoryRemoveRecursive(IN_BSTR aPath, ComSafeArrayIn(DirectoryRemoveRecFlag_T, aFlags), IProgress **aProgress)
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::DirectoryRename(IN_BSTR aSource, IN_BSTR aDest, ComSafeArrayIn(PathRenameFlag_T, aFlags))
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::DirectorySetACL(IN_BSTR aPath, IN_BSTR aACL)
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsyncSTDMETHODIMP GuestSession::EnvironmentGet(IN_BSTR aName, BSTR *aValue)
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync if (RT_UNLIKELY((aName) == NULL || *(aName) == '\0'))
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync return setError(E_INVALIDARG, tr("No value name specified"));
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync Bstr strValue(mData.mEnvironment.Get(Utf8Str(aName)));
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::EnvironmentSet(IN_BSTR aName, IN_BSTR aValue)
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync if (RT_UNLIKELY((aName) == NULL || *(aName) == '\0'))
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync return setError(E_INVALIDARG, tr("No value name specified"));
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync int rc = mData.mEnvironment.Set(Utf8Str(aName), Utf8Str(aValue));
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync HRESULT hr = RT_SUCCESS(rc) ? S_OK : VBOX_E_IPRT_ERROR;
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
7862f4bd000f1eb6c86289f5ac2849e9cf943ca9vboxsyncSTDMETHODIMP GuestSession::EnvironmentUnset(IN_BSTR aName)
92e624e40b06b4dc6d0a8222e1de33bd3e879a63vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::FileCreateTemp(IN_BSTR aTemplate, ULONG aMode, IN_BSTR aPath, BOOL aSecure, IGuestFile **aFile)
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
58c0567dee3cc3ebe62dec1e27f8e35bac4ddeb0vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::FileExists(IN_BSTR aPath, BOOL *aExists)
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync if (RT_UNLIKELY((aPath) == NULL || *(aPath) == '\0'))
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync return setError(E_INVALIDARG, tr("No file to check existence for specified"));
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
b8bb9c9f6b8ebfd0a7d6df0c0289f9fe80241750vboxsync int vrc = fileQueryInfoInternal(Utf8Str(aPath), objData, &guestRc);
58c0567dee3cc3ebe62dec1e27f8e35bac4ddeb0vboxsync hr = GuestProcess::setErrorExternal(this, guestRc);
9e17ca2e9d797e845e3284141dd4086a4b817ae5vboxsync hr = setError(VBOX_E_IPRT_ERROR, tr("Querying file information for \"%s\" failed: %Rrc"),
9e17ca2e9d797e845e3284141dd4086a4b817ae5vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
9e17ca2e9d797e845e3284141dd4086a4b817ae5vboxsyncSTDMETHODIMP GuestSession::FileRemove(IN_BSTR aPath)
9e17ca2e9d797e845e3284141dd4086a4b817ae5vboxsync if (RT_UNLIKELY((aPath) == NULL || *(aPath) == '\0'))
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync return setError(E_INVALIDARG, tr("No file to remove specified"));
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync int vrc = fileRemoveInternal(Utf8Str(aPath), &guestRc);
9e17ca2e9d797e845e3284141dd4086a4b817ae5vboxsync hr = GuestProcess::setErrorExternal(this, guestRc);
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync hr = setError(VBOX_E_IPRT_ERROR, tr("Removing file \"%s\" failed: %Rrc"),
5366e994777f9d9391cf809dc77610f57270d75dvboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
5366e994777f9d9391cf809dc77610f57270d75dvboxsyncSTDMETHODIMP GuestSession::FileOpen(IN_BSTR aPath, IN_BSTR aOpenMode, IN_BSTR aDisposition, ULONG aCreationMode, LONG64 aOffset, IGuestFile **aFile)
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync if (RT_UNLIKELY((aPath) == NULL || *(aPath) == '\0'))
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync return setError(E_INVALIDARG, tr("No file to open specified"));
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync if (RT_UNLIKELY((aOpenMode) == NULL || *(aOpenMode) == '\0'))
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync return setError(E_INVALIDARG, tr("No open mode specified"));
c55bf74b54ecdfb5ebc4e5d90b620d0fee31737evboxsync if (RT_UNLIKELY((aDisposition) == NULL || *(aDisposition) == '\0'))
5366e994777f9d9391cf809dc77610f57270d75dvboxsync return setError(E_INVALIDARG, tr("No disposition mode specified"));
5366e994777f9d9391cf809dc77610f57270d75dvboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync /** @todo Validate open mode. */
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync /** @todo Validate disposition mode. */
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync /** @todo Validate creation mode. */
d8e12fa5dd1c35282b98cb165e42b6b395cf971bvboxsync int vrc = fileOpenInternal(openInfo, pFile, &guestRc);
5366e994777f9d9391cf809dc77610f57270d75dvboxsync /* Return directory object to the caller. */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync hr = setError(VBOX_E_IPRT_ERROR, tr("Opening guest file \"%s\" failed: %Rrc"),
4121d226ac899f17e13aff3aff42b603c8b5c1fevboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::FileQueryInfo(IN_BSTR aPath, IGuestFsObjInfo **aInfo)
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync if (RT_UNLIKELY((aPath) == NULL || *(aPath) == '\0'))
4121d226ac899f17e13aff3aff42b603c8b5c1fevboxsync return setError(E_INVALIDARG, tr("No file to query information for specified"));
4121d226ac899f17e13aff3aff42b603c8b5c1fevboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync int vrc = fileQueryInfoInternal(Utf8Str(aPath), objData, &guestRc);
4121d226ac899f17e13aff3aff42b603c8b5c1fevboxsync hr = GuestProcess::setErrorExternal(this, guestRc);
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync hr = setError(VBOX_E_IPRT_ERROR, tr("Element exists but is not a file"));
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync hr = setError(VBOX_E_IPRT_ERROR, tr("Querying file information failed: %Rrc"), vrc);
e378dfdadd62aadc0a012c9953322d979d7606e6vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::FileQuerySize(IN_BSTR aPath, LONG64 *aSize)
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync if (RT_UNLIKELY((aPath) == NULL || *(aPath) == '\0'))
e378dfdadd62aadc0a012c9953322d979d7606e6vboxsync return setError(E_INVALIDARG, tr("No file to query size for specified"));
e378dfdadd62aadc0a012c9953322d979d7606e6vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
5050fc8de0b121eab1b738d7c1007cde4903284dvboxsync int vrc = fileQuerySizeInternal(Utf8Str(aPath), &llSize, &guestRc);
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync hr = GuestProcess::setErrorExternal(this, guestRc);
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync hr = setError(VBOX_E_IPRT_ERROR, tr("Querying file size failed: %Rrc"), vrc);
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::FileRename(IN_BSTR aSource, IN_BSTR aDest, ComSafeArrayIn(PathRenameFlag_T, aFlags))
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::FileSetACL(IN_BSTR aPath, IN_BSTR aACL)
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
cd5df721f068659172f3bf95de8fedeb465f057dvboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
cd5df721f068659172f3bf95de8fedeb465f057dvboxsyncSTDMETHODIMP GuestSession::ProcessCreate(IN_BSTR aCommand, ComSafeArrayIn(IN_BSTR, aArguments), ComSafeArrayIn(IN_BSTR, aEnvironment),
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync ComSafeArrayIn(ProcessCreateFlag_T, aFlags), ULONG aTimeoutMS, IGuestProcess **aProcess)
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync return ProcessCreateEx(aCommand, ComSafeArrayInArg(aArguments), ComSafeArrayInArg(aEnvironment),
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync ComSafeArrayInArg(aFlags), aTimeoutMS, ProcessPriority_Default, ComSafeArrayAsInParam(affinityIgnored), aProcess);
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
687794577e2e35c3cae67e692a7f2130d1262a82vboxsyncSTDMETHODIMP GuestSession::ProcessCreateEx(IN_BSTR aCommand, ComSafeArrayIn(IN_BSTR, aArguments), ComSafeArrayIn(IN_BSTR, aEnvironment),
687794577e2e35c3cae67e692a7f2130d1262a82vboxsync ComSafeArrayIn(ProcessCreateFlag_T, aFlags), ULONG aTimeoutMS,
687794577e2e35c3cae67e692a7f2130d1262a82vboxsync ProcessPriority_T aPriority, ComSafeArrayIn(LONG, aAffinity),
5366e994777f9d9391cf809dc77610f57270d75dvboxsync if (RT_UNLIKELY((aCommand) == NULL || *(aCommand) == '\0'))
5f2b03bf7695dabd71222dba123532a3f76828c1vboxsync return setError(E_INVALIDARG, tr("No command to execute specified"));
907b6adfa052386a0666d5557bee9bdbc100c2e5vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
7862f4bd000f1eb6c86289f5ac2849e9cf943ca9vboxsync com::SafeArray<IN_BSTR> arguments(ComSafeArrayInArg(aArguments));
907b6adfa052386a0666d5557bee9bdbc100c2e5vboxsync procInfo.mArguments.push_back(Utf8Str(arguments[i]));
cc1ef2ef9bbc6a0ff964928d61b7298e5bfcce5fvboxsync * Create the process environment:
907b6adfa052386a0666d5557bee9bdbc100c2e5vboxsync * - Apply the session environment in a first step, and
7862f4bd000f1eb6c86289f5ac2849e9cf943ca9vboxsync * - Apply environment variables specified by this call to
7862f4bd000f1eb6c86289f5ac2849e9cf943ca9vboxsync * have the chance of overwriting/deleting session entries.
907b6adfa052386a0666d5557bee9bdbc100c2e5vboxsync procInfo.mEnvironment = mData.mEnvironment; /* Apply original session environment. */
907b6adfa052386a0666d5557bee9bdbc100c2e5vboxsync com::SafeArray<IN_BSTR> environment(ComSafeArrayInArg(aEnvironment));
907b6adfa052386a0666d5557bee9bdbc100c2e5vboxsync for (size_t i = 0; i < environment.size() && RT_SUCCESS(rc); i++)
5f2b03bf7695dabd71222dba123532a3f76828c1vboxsync rc = procInfo.mEnvironment.Set(Utf8Str(environment[i]));
462e60a19d02a99b2b1a5c08dff74bb0808d707cvboxsync com::SafeArray<ProcessCreateFlag_T> flags(ComSafeArrayInArg(aFlags));
ed9d3db07648c7e3a979105c15ad752ee9ea18devboxsync com::SafeArray<LONG> affinity(ComSafeArrayInArg(aAffinity));
ed9d3db07648c7e3a979105c15ad752ee9ea18devboxsync /* Return guest session to the caller. */
ed9d3db07648c7e3a979105c15ad752ee9ea18devboxsync hr = setError(VBOX_E_IPRT_ERROR, tr("Maximum number of concurrent guest processes per session (%ld) reached"),
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync /** @todo Add more errors here. */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync hr = setError(VBOX_E_IPRT_ERROR, tr("Could not create guest process, rc=%Rrc"), rc);
687794577e2e35c3cae67e692a7f2130d1262a82vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::ProcessGet(ULONG aPID, IGuestProcess **aProcess)
687794577e2e35c3cae67e692a7f2130d1262a82vboxsync return setError(E_INVALIDARG, tr("No valid process ID (PID) specified"));
687794577e2e35c3cae67e692a7f2130d1262a82vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync hr = setError(E_INVALIDARG, tr("No process with PID %RU32 found"), aPID);
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync /* This will set (*aProcess) to NULL if pProgress is NULL. */
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync LogFlowThisFunc(("aProcess=%p, hr=%Rhrc\n", *aProcess, hr));
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::SymlinkCreate(IN_BSTR aSource, IN_BSTR aTarget, SymlinkType_T aType)
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::SymlinkExists(IN_BSTR aSymlink, BOOL *aExists)
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::SymlinkRead(IN_BSTR aSymlink, ComSafeArrayIn(SymlinkReadFlag_T, aFlags), BSTR *aTarget)
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::SymlinkRemoveDirectory(IN_BSTR aPath)
702a8ee2dc1de96f2f77e97135015d3e243186fdvboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
2f3883b126a405f92b19e829472f614c7352b4f9vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
2f3883b126a405f92b19e829472f614c7352b4f9vboxsyncSTDMETHODIMP GuestSession::SymlinkRemoveFile(IN_BSTR aFile)
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsyncSTDMETHODIMP GuestSession::WaitFor(ULONG aWaitFlags, ULONG aTimeoutMS, GuestSessionWaitResult_T *aReason)
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync * Note: Do not hold any locks here while waiting!
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync int vrc = waitFor(aWaitFlags, aTimeoutMS, waitResult, &guestRc);
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync hr = GuestSession::setErrorExternal(this, guestRc);
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync const char *pszSessionName = mData.mSession.mName.c_str();
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync tr("Waiting for guest session \"%s\" failed: %Rrc"),
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync pszSessionName ? pszSessionName : tr("Unnamed"), vrc);
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync#endif /* VBOX_WITH_GUEST_CONTROL */
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsyncSTDMETHODIMP GuestSession::WaitForArray(ComSafeArrayIn(GuestSessionWaitForFlag_T, aFlags), ULONG aTimeoutMS, GuestSessionWaitResult_T *aReason)
9bff17fe6983cfda2ddd98f1979841bcb48e78e7vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();