- * 'dpif'. On success, stores a new odp_flow into 'flow' and returns 0.
- * Returns EOF if the end of the flow table has been reached, or a positive
- * errno value on error. This function will not be called again once it
- * returns nonzero once for a given iteration (but the 'flow_dump_done'
- * function will be called afterward).
+ * 'dpif'. On success, updates the output parameters as described below
+ * and returns 0. Returns EOF if the end of the flow table has been
+ * reached, or a positive errno value on error. This function will not be
+ * called again once it returns nonzero within a given iteration (but the
+ * 'flow_dump_done' function will be called afterward).
+ *
+ * On success, if 'key' and 'key_len' are nonnull then '*key' and
+ * '*key_len' must be set to Netlink attributes with types ODP_KEY_ATTR_*
+ * representing the dumped flow's key. If 'actions' and 'actions_len' are
+ * nonnull then they should be set to Netlink attributes with types ODPAT_*
+ * representing the dumped flow's actions. If 'stats' is nonnull then it
+ * should be set to the dumped flow's statistics.