2 * QEMU Guest Agent win32-specific command implementations
4 * Copyright IBM Corp. 2012
7 * Michael Roth <mdroth@linux.vnet.ibm.com>
8 * Gal Hammer <ghammer@redhat.com>
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 Error
*local_err
= NULL
;
91 UINT shutdown_flag
= EWX_FORCE
;
93 slog("guest-shutdown called, mode: %s", mode
);
95 if (!has_mode
|| strcmp(mode
, "powerdown") == 0) {
96 shutdown_flag
|= EWX_POWEROFF
;
97 } else if (strcmp(mode
, "halt") == 0) {
98 shutdown_flag
|= EWX_SHUTDOWN
;
99 } else if (strcmp(mode
, "reboot") == 0) {
100 shutdown_flag
|= EWX_REBOOT
;
102 error_set(errp
, QERR_INVALID_PARAMETER_VALUE
, "mode",
103 "halt|powerdown|reboot");
107 /* Request a shutdown privilege, but try to shut down the system
109 acquire_privilege(SE_SHUTDOWN_NAME
, &local_err
);
111 error_propagate(errp
, local_err
);
115 if (!ExitWindowsEx(shutdown_flag
, SHTDN_REASON_FLAG_PLANNED
)) {
116 slog("guest-shutdown failed: %lu", GetLastError());
117 error_set(errp
, QERR_UNDEFINED_ERROR
);
121 int64_t qmp_guest_file_open(const char *path
, bool has_mode
, const char *mode
,
124 error_set(errp
, QERR_UNSUPPORTED
);
128 void qmp_guest_file_close(int64_t handle
, Error
**errp
)
130 error_set(errp
, QERR_UNSUPPORTED
);
133 GuestFileRead
*qmp_guest_file_read(int64_t handle
, bool has_count
,
134 int64_t count
, Error
**errp
)
136 error_set(errp
, QERR_UNSUPPORTED
);
140 GuestFileWrite
*qmp_guest_file_write(int64_t handle
, const char *buf_b64
,
141 bool has_count
, int64_t count
,
144 error_set(errp
, QERR_UNSUPPORTED
);
148 GuestFileSeek
*qmp_guest_file_seek(int64_t handle
, int64_t offset
,
149 int64_t whence
, Error
**errp
)
151 error_set(errp
, QERR_UNSUPPORTED
);
155 void qmp_guest_file_flush(int64_t handle
, Error
**errp
)
157 error_set(errp
, QERR_UNSUPPORTED
);
161 * Return status of freeze/thaw
163 GuestFsfreezeStatus
qmp_guest_fsfreeze_status(Error
**errp
)
165 if (!vss_initialized()) {
166 error_set(errp
, QERR_UNSUPPORTED
);
170 if (ga_is_frozen(ga_state
)) {
171 return GUEST_FSFREEZE_STATUS_FROZEN
;
174 return GUEST_FSFREEZE_STATUS_THAWED
;
178 * Freeze local file systems using Volume Shadow-copy Service.
179 * The frozen state is limited for up to 10 seconds by VSS.
181 int64_t qmp_guest_fsfreeze_freeze(Error
**errp
)
184 Error
*local_err
= NULL
;
186 if (!vss_initialized()) {
187 error_set(errp
, QERR_UNSUPPORTED
);
191 slog("guest-fsfreeze called");
193 /* cannot risk guest agent blocking itself on a write in this state */
194 ga_set_frozen(ga_state
);
196 qga_vss_fsfreeze(&i
, &local_err
, true);
198 error_propagate(errp
, local_err
);
206 qmp_guest_fsfreeze_thaw(&local_err
);
208 g_debug("cleanup thaw: %s", error_get_pretty(local_err
));
209 error_free(local_err
);
215 * Thaw local file systems using Volume Shadow-copy Service.
217 int64_t qmp_guest_fsfreeze_thaw(Error
**errp
)
221 if (!vss_initialized()) {
222 error_set(errp
, QERR_UNSUPPORTED
);
226 qga_vss_fsfreeze(&i
, errp
, false);
228 ga_unset_frozen(ga_state
);
232 static void guest_fsfreeze_cleanup(void)
236 if (!vss_initialized()) {
240 if (ga_is_frozen(ga_state
) == GUEST_FSFREEZE_STATUS_FROZEN
) {
241 qmp_guest_fsfreeze_thaw(&err
);
243 slog("failed to clean up frozen filesystems: %s",
244 error_get_pretty(err
));
253 * Walk list of mounted file systems in the guest, and discard unused
256 void qmp_guest_fstrim(bool has_minimum
, int64_t minimum
, Error
**errp
)
258 error_set(errp
, QERR_UNSUPPORTED
);
262 GUEST_SUSPEND_MODE_DISK
,
263 GUEST_SUSPEND_MODE_RAM
266 static void check_suspend_mode(GuestSuspendMode mode
, Error
**errp
)
268 SYSTEM_POWER_CAPABILITIES sys_pwr_caps
;
269 Error
*local_err
= NULL
;
271 if (error_is_set(errp
)) {
274 ZeroMemory(&sys_pwr_caps
, sizeof(sys_pwr_caps
));
275 if (!GetPwrCapabilities(&sys_pwr_caps
)) {
276 error_set(&local_err
, QERR_QGA_COMMAND_FAILED
,
277 "failed to determine guest suspend capabilities");
282 case GUEST_SUSPEND_MODE_DISK
:
283 if (!sys_pwr_caps
.SystemS4
) {
284 error_set(&local_err
, QERR_QGA_COMMAND_FAILED
,
285 "suspend-to-disk not supported by OS");
288 case GUEST_SUSPEND_MODE_RAM
:
289 if (!sys_pwr_caps
.SystemS3
) {
290 error_set(&local_err
, QERR_QGA_COMMAND_FAILED
,
291 "suspend-to-ram not supported by OS");
295 error_set(&local_err
, QERR_INVALID_PARAMETER_VALUE
, "mode",
301 error_propagate(errp
, local_err
);
305 static DWORD WINAPI
do_suspend(LPVOID opaque
)
307 GuestSuspendMode
*mode
= opaque
;
310 if (!SetSuspendState(*mode
== GUEST_SUSPEND_MODE_DISK
, TRUE
, TRUE
)) {
311 slog("failed to suspend guest, %lu", GetLastError());
318 void qmp_guest_suspend_disk(Error
**errp
)
320 Error
*local_err
= NULL
;
321 GuestSuspendMode
*mode
= g_malloc(sizeof(GuestSuspendMode
));
323 *mode
= GUEST_SUSPEND_MODE_DISK
;
324 check_suspend_mode(*mode
, &local_err
);
325 acquire_privilege(SE_SHUTDOWN_NAME
, &local_err
);
326 execute_async(do_suspend
, mode
, &local_err
);
329 error_propagate(errp
, local_err
);
334 void qmp_guest_suspend_ram(Error
**errp
)
336 Error
*local_err
= NULL
;
337 GuestSuspendMode
*mode
= g_malloc(sizeof(GuestSuspendMode
));
339 *mode
= GUEST_SUSPEND_MODE_RAM
;
340 check_suspend_mode(*mode
, &local_err
);
341 acquire_privilege(SE_SHUTDOWN_NAME
, &local_err
);
342 execute_async(do_suspend
, mode
, &local_err
);
345 error_propagate(errp
, local_err
);
350 void qmp_guest_suspend_hybrid(Error
**errp
)
352 error_set(errp
, QERR_UNSUPPORTED
);
355 GuestNetworkInterfaceList
*qmp_guest_network_get_interfaces(Error
**errp
)
357 error_set(errp
, QERR_UNSUPPORTED
);
361 int64_t qmp_guest_get_time(Error
**errp
)
368 if (ts
.wYear
< 1601 || ts
.wYear
> 30827) {
369 error_setg(errp
, "Failed to get time");
373 if (!SystemTimeToFileTime(&ts
, &tf
)) {
374 error_setg(errp
, "Failed to convert system time: %d", (int)GetLastError());
378 time_ns
= ((((int64_t)tf
.dwHighDateTime
<< 32) | tf
.dwLowDateTime
)
379 - W32_FT_OFFSET
) * 100;
384 void qmp_guest_set_time(bool has_time
, int64_t time_ns
, Error
**errp
)
386 Error
*local_err
= NULL
;
392 /* Okay, user passed a time to set. Validate it. */
393 if (time_ns
< 0 || time_ns
/ 100 > INT64_MAX
- W32_FT_OFFSET
) {
394 error_setg(errp
, "Time %" PRId64
"is invalid", time_ns
);
398 time
= time_ns
/ 100 + W32_FT_OFFSET
;
400 tf
.dwLowDateTime
= (DWORD
) time
;
401 tf
.dwHighDateTime
= (DWORD
) (time
>> 32);
403 if (!FileTimeToSystemTime(&tf
, &ts
)) {
404 error_setg(errp
, "Failed to convert system time %d",
405 (int)GetLastError());
409 /* Otherwise read the time from RTC which contains the correct value.
412 if (ts
.wYear
< 1601 || ts
.wYear
> 30827) {
413 error_setg(errp
, "Failed to get time");
418 acquire_privilege(SE_SYSTEMTIME_NAME
, &local_err
);
420 error_propagate(errp
, local_err
);
424 if (!SetSystemTime(&ts
)) {
425 error_setg(errp
, "Failed to set time to guest: %d", (int)GetLastError());
430 GuestLogicalProcessorList
*qmp_guest_get_vcpus(Error
**errp
)
432 error_set(errp
, QERR_UNSUPPORTED
);
436 int64_t qmp_guest_set_vcpus(GuestLogicalProcessorList
*vcpus
, Error
**errp
)
438 error_set(errp
, QERR_UNSUPPORTED
);
442 /* register init/cleanup routines for stateful command groups */
443 void ga_command_state_init(GAState
*s
, GACommandState
*cs
)
445 if (vss_init(true)) {
446 ga_command_state_add(cs
, NULL
, guest_fsfreeze_cleanup
);