2 * QEMU Guest Agent win32-specific command implementations
4 * Copyright IBM Corp. 2012
10 * This work is licensed under the terms of the GNU GPL, version 2 or later.
11 * See the COPYING file in the top-level directory.
17 #include "qga/guest-agent-core.h"
18 #include "qga/vss-win32.h"
19 #include "qga-qmp-commands.h"
20 #include "qapi/qmp/qerror.h"
22 #ifndef SHTDN_REASON_FLAG_PLANNED
23 #define SHTDN_REASON_FLAG_PLANNED 0x80000000
26 /* multiple of 100 nanoseconds elapsed between windows baseline
27 * (1/1/1601) and Unix Epoch (1/1/1970), accounting for leap years */
28 #define W32_FT_OFFSET (10000000ULL * 60 * 60 * 24 * \
29 (365 * (1970 - 1601) + \
30 (1970 - 1601) / 4 - 3))
32 static void acquire_privilege(const char *name, Error **errp)
35 TOKEN_PRIVILEGES priv;
36 Error *local_err = NULL;
38 if (error_is_set(errp)) {
42 if (OpenProcessToken(GetCurrentProcess(),
43 TOKEN_ADJUST_PRIVILEGES|TOKEN_QUERY, &token))
45 if (!LookupPrivilegeValue(NULL, name, &priv.Privileges[0].Luid)) {
46 error_set(&local_err, QERR_QGA_COMMAND_FAILED,
47 "no luid for requested privilege");
51 priv.PrivilegeCount = 1;
52 priv.Privileges[0].Attributes = SE_PRIVILEGE_ENABLED;
54 if (!AdjustTokenPrivileges(token, FALSE, &priv, 0, NULL, 0)) {
55 error_set(&local_err, QERR_QGA_COMMAND_FAILED,
56 "unable to acquire requested privilege");
62 error_set(&local_err, QERR_QGA_COMMAND_FAILED,
63 "failed to open privilege token");
68 error_propagate(errp, local_err);
72 static void execute_async(DWORD WINAPI (*func)(LPVOID), LPVOID opaque,
75 Error *local_err = NULL;
77 if (error_is_set(errp)) {
80 HANDLE thread = CreateThread(NULL, 0, func, opaque, 0, NULL);
82 error_set(&local_err, QERR_QGA_COMMAND_FAILED,
83 "failed to dispatch asynchronous command");
84 error_propagate(errp, local_err);
88 void qmp_guest_shutdown(bool has_mode, const char *mode, Error **errp)
90 UINT shutdown_flag = EWX_FORCE;
92 slog("guest-shutdown called, mode: %s", mode);
94 if (!has_mode || strcmp(mode, "powerdown") == 0) {
95 shutdown_flag |= EWX_POWEROFF;
96 } else if (strcmp(mode, "halt") == 0) {
97 shutdown_flag |= EWX_SHUTDOWN;
98 } else if (strcmp(mode, "reboot") == 0) {
99 shutdown_flag |= EWX_REBOOT;
101 error_set(errp, QERR_INVALID_PARAMETER_VALUE, "mode",
102 "halt|powerdown|reboot");
106 /* Request a shutdown privilege, but try to shut down the system
108 acquire_privilege(SE_SHUTDOWN_NAME, errp);
109 if (error_is_set(errp)) {
113 if (!ExitWindowsEx(shutdown_flag, SHTDN_REASON_FLAG_PLANNED)) {
114 slog("guest-shutdown failed: %lu", GetLastError());
115 error_set(errp, QERR_UNDEFINED_ERROR);
119 int64_t qmp_guest_file_open(const char *path, bool has_mode, const char *mode,
122 error_set(errp, QERR_UNSUPPORTED);
126 void qmp_guest_file_close(int64_t handle, Error **errp)
128 error_set(errp, QERR_UNSUPPORTED);
131 GuestFileRead *qmp_guest_file_read(int64_t handle, bool has_count,
132 int64_t count, Error **errp)
134 error_set(errp, QERR_UNSUPPORTED);
138 GuestFileWrite *qmp_guest_file_write(int64_t handle, const char *buf_b64,
139 bool has_count, int64_t count,
142 error_set(errp, QERR_UNSUPPORTED);
146 GuestFileSeek *qmp_guest_file_seek(int64_t handle, int64_t offset,
147 int64_t whence, Error **errp)
149 error_set(errp, QERR_UNSUPPORTED);
153 void qmp_guest_file_flush(int64_t handle, Error **errp)
155 error_set(errp, QERR_UNSUPPORTED);
159 * Return status of freeze/thaw
161 GuestFsfreezeStatus qmp_guest_fsfreeze_status(Error **errp)
163 if (!vss_initialized()) {
164 error_set(errp, QERR_UNSUPPORTED);
168 if (ga_is_frozen(ga_state)) {
169 return GUEST_FSFREEZE_STATUS_FROZEN;
172 return GUEST_FSFREEZE_STATUS_THAWED;
176 * Freeze local file systems using Volume Shadow-copy Service.
177 * The frozen state is limited for up to 10 seconds by VSS.
179 int64_t qmp_guest_fsfreeze_freeze(Error **errp)
182 Error *local_err = NULL;
184 if (!vss_initialized()) {
185 error_set(errp, QERR_UNSUPPORTED);
189 slog("guest-fsfreeze called");
191 /* cannot risk guest agent blocking itself on a write in this state */
192 ga_set_frozen(ga_state);
194 qga_vss_fsfreeze(&i, errp, true);
195 if (error_is_set(errp)) {
202 qmp_guest_fsfreeze_thaw(&local_err);
204 g_debug("cleanup thaw: %s", error_get_pretty(local_err));
205 error_free(local_err);
211 * Thaw local file systems using Volume Shadow-copy Service.
213 int64_t qmp_guest_fsfreeze_thaw(Error **errp)
217 if (!vss_initialized()) {
218 error_set(errp, QERR_UNSUPPORTED);
222 qga_vss_fsfreeze(&i, errp, false);
224 ga_unset_frozen(ga_state);
228 static void guest_fsfreeze_cleanup(void)
232 if (!vss_initialized()) {
236 if (ga_is_frozen(ga_state) == GUEST_FSFREEZE_STATUS_FROZEN) {
237 qmp_guest_fsfreeze_thaw(&err);
239 slog("failed to clean up frozen filesystems: %s",
240 error_get_pretty(err));
249 * Walk list of mounted file systems in the guest, and discard unused
252 void qmp_guest_fstrim(bool has_minimum, int64_t minimum, Error **errp)
254 error_set(errp, QERR_UNSUPPORTED);
258 GUEST_SUSPEND_MODE_DISK,
259 GUEST_SUSPEND_MODE_RAM
262 static void check_suspend_mode(GuestSuspendMode mode, Error **errp)
264 SYSTEM_POWER_CAPABILITIES sys_pwr_caps;
265 Error *local_err = NULL;
267 if (error_is_set(errp)) {
270 ZeroMemory(&sys_pwr_caps, sizeof(sys_pwr_caps));
271 if (!GetPwrCapabilities(&sys_pwr_caps)) {
272 error_set(&local_err, QERR_QGA_COMMAND_FAILED,
273 "failed to determine guest suspend capabilities");
278 case GUEST_SUSPEND_MODE_DISK:
279 if (!sys_pwr_caps.SystemS4) {
280 error_set(&local_err, QERR_QGA_COMMAND_FAILED,
281 "suspend-to-disk not supported by OS");
284 case GUEST_SUSPEND_MODE_RAM:
285 if (!sys_pwr_caps.SystemS3) {
286 error_set(&local_err, QERR_QGA_COMMAND_FAILED,
287 "suspend-to-ram not supported by OS");
291 error_set(&local_err, QERR_INVALID_PARAMETER_VALUE, "mode",
297 error_propagate(errp, local_err);
301 static DWORD WINAPI do_suspend(LPVOID opaque)
303 GuestSuspendMode *mode = opaque;
306 if (!SetSuspendState(*mode == GUEST_SUSPEND_MODE_DISK, TRUE, TRUE)) {
307 slog("failed to suspend guest, %lu", GetLastError());
314 void qmp_guest_suspend_disk(Error **errp)
316 GuestSuspendMode *mode = g_malloc(sizeof(GuestSuspendMode));
318 *mode = GUEST_SUSPEND_MODE_DISK;
319 check_suspend_mode(*mode, errp);
320 acquire_privilege(SE_SHUTDOWN_NAME, errp);
321 execute_async(do_suspend, mode, errp);
323 if (error_is_set(errp)) {
328 void qmp_guest_suspend_ram(Error **errp)
330 GuestSuspendMode *mode = g_malloc(sizeof(GuestSuspendMode));
332 *mode = GUEST_SUSPEND_MODE_RAM;
333 check_suspend_mode(*mode, errp);
334 acquire_privilege(SE_SHUTDOWN_NAME, errp);
335 execute_async(do_suspend, mode, errp);
337 if (error_is_set(errp)) {
342 void qmp_guest_suspend_hybrid(Error **errp)
344 error_set(errp, QERR_UNSUPPORTED);
347 GuestNetworkInterfaceList *qmp_guest_network_get_interfaces(Error **errp)
349 error_set(errp, QERR_UNSUPPORTED);
353 int64_t qmp_guest_get_time(Error **errp)
360 if (ts.wYear < 1601 || ts.wYear > 30827) {
361 error_setg(errp, "Failed to get time");
365 if (!SystemTimeToFileTime(&ts, &tf)) {
366 error_setg(errp, "Failed to convert system time: %d", (int)GetLastError());
370 time_ns = ((((int64_t)tf.dwHighDateTime << 32) | tf.dwLowDateTime)
371 - W32_FT_OFFSET) * 100;
376 void qmp_guest_set_time(bool has_time, int64_t time_ns, Error **errp)
383 /* Okay, user passed a time to set. Validate it. */
384 if (time_ns < 0 || time_ns / 100 > INT64_MAX - W32_FT_OFFSET) {
385 error_setg(errp, "Time %" PRId64 "is invalid", time_ns);
389 time = time_ns / 100 + W32_FT_OFFSET;
391 tf.dwLowDateTime = (DWORD) time;
392 tf.dwHighDateTime = (DWORD) (time >> 32);
394 if (!FileTimeToSystemTime(&tf, &ts)) {
395 error_setg(errp, "Failed to convert system time %d",
396 (int)GetLastError());
400 /* Otherwise read the time from RTC which contains the correct value.
403 if (ts.wYear < 1601 || ts.wYear > 30827) {
404 error_setg(errp, "Failed to get time");
409 acquire_privilege(SE_SYSTEMTIME_NAME, errp);
410 if (error_is_set(errp)) {
414 if (!SetSystemTime(&ts)) {
415 error_setg(errp, "Failed to set time to guest: %d", (int)GetLastError());
420 GuestLogicalProcessorList *qmp_guest_get_vcpus(Error **errp)
422 error_set(errp, QERR_UNSUPPORTED);
426 int64_t qmp_guest_set_vcpus(GuestLogicalProcessorList *vcpus, Error **errp)
428 error_set(errp, QERR_UNSUPPORTED);
432 /* register init/cleanup routines for stateful command groups */
433 void ga_command_state_init(GAState *s, GACommandState *cs)
435 if (vss_init(true)) {
436 ga_command_state_add(cs, NULL, guest_fsfreeze_cleanup);