/*
 * Copyright (c) 2011 Gaetano Catalli. 
 * 
 * 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 list of conditions and the following disclaimer in the
 *       documentation and/or other materials provided with the distribution.
 * 
 * THIS SOFTWARE IS PROVIDED ``AS IS'' WITHOUT ANY WARRANTIES OF ANY KIND.
 */

#ifndef RTBSD_H
#define RTBSD_H 1

#include "list.h"

/*
 * A digested version of a message received from a PF_ROUTE socket which
 * indicates that a network device has been created or destroyed or changed. 
 */
struct rtbsd_change {
    /* Copied from struct if_msghdr. */
    int msg_type;             /* e.g. XXX. */

    /* Copied from struct if_msghdr. */
    int if_index;              /* Index of network device. */

    char if_name[IF_NAMESIZE];         /* Name of network device. */
    int master_ifindex;         /* Ifindex of datapath master (0 if none). */
};

/*
 * Function called to report that a netdev has changed.  'change' describes the
 * specific change.  It may be null if the buffer of change information
 * overflowed, in which case the function must assume that every device may
 * have changed.  'aux' is as specified in the call to
 * rtbsd_notifier_register(). 
 */
typedef void rtbsd_notify_func(const struct rtbsd_change *, void *aux);

struct rtbsd_notifier {
    struct list node;
    rtbsd_notify_func *cb;
    void *aux;
};

int rtbsd_notifier_register(struct rtbsd_notifier *,
                                rtbsd_notify_func *, void *aux);
void rtbsd_notifier_unregister(struct rtbsd_notifier *);
void rtbsd_notifier_run(void);
void rtbsd_notifier_wait(void);

#endif /* rtbsd.h */