Document memory ownership.

diff --git a/src/net/udp/dhcp.c b/src/net/udp/dhcp.c
index 3a1951c..466259a 100644 (file)
--- a/src/net/udp/dhcp.c
+++ b/src/net/udp/dhcp.c
@@ -650,6 +650,11 @@ static struct udp_operations dhcp_udp_operations = {
  *
  * @v dhcp             DHCP session
  * @ret aop            Asynchronous operation
  *
  * @v dhcp             DHCP session
  * @ret aop            Asynchronous operation

+ *
+ * If the DHCP operation completes successfully, the
+ * dhcp_session::options field will be filled in with the resulting
+ * options block.  The caller takes responsibility for eventually
+ * calling free_dhcp_options().

  */
 struct async_operation * start_dhcp ( struct dhcp_session *dhcp ) {
        int rc;
  */
 struct async_operation * start_dhcp ( struct dhcp_session *dhcp ) {
        int rc;