$FreeBSD: releng/11.0/share/man/man4/hv_kvp.4 276259 2014-12-26 22:30:18Z bapt $ Copyright (c) 2012 Microsoft Corp. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this...
NAMEhv_kvp - Hyper-V Key Value Pair Driver
SYNOPSISTo compile this driver into the kernel, place the following lines in the system kernel configuration file:
DESCRIPTIONThe ifconfig driver provides the ability to store, retrieve, modify and delete key value pairs for Fx guest partitions running on Hyper-V. Hyper-V allows administrators to store custom metadata in the form of key value pairs inside the Fx guest partition. Administrators can use Windows Powershell scripts to add, read, modify and delete such key value pairs.
The driver is bare bones and merely forwards requests to its counterpart user mode daemon, hv_kvp_daemon8. The daemon maintains pools of key value pairs and does the actual metadata management.
The same driver and daemon combination are also used to set and get IP addresses from a Fx guest.
The set functionality is particularly useful when the Fx guest is assigned a static IP address and is failed over from one Hyper-V host to another. After failover, Hyper-V uses the set IP functionality to automatically update the Fx guest's IP address to its original static value.
On the other hand, the get IP functionality is used to update the guest IP address in the Hyper-V management console window.