hwaddr.h 1.5 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647
  1. // Copyright (C) 2012 Internet Systems Consortium, Inc. ("ISC")
  2. //
  3. // Permission to use, copy, modify, and/or distribute this software for any
  4. // purpose with or without fee is hereby granted, provided that the above
  5. // copyright notice and this permission notice appear in all copies.
  6. //
  7. // THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
  8. // REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
  9. // AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
  10. // INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  11. // LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  12. // OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  13. // PERFORMANCE OF THIS SOFTWARE.
  14. #ifndef __HWADDR_H
  15. #define __HWADDR_H
  16. #include <string>
  17. #include <vector>
  18. #include <stdint.h>
  19. namespace isc {
  20. namespace dhcp {
  21. /// @brief Hardware Address
  22. typedef std::vector<uint8_t> HWAddr;
  23. /// @brief Produce string representation of hardware address
  24. ///
  25. /// Returns a string containing the hardware address. This is only used for
  26. /// logging.
  27. ///
  28. /// @note Six characters is an arbitrary length, chosen to provide a
  29. /// suitably wide string.
  30. ///
  31. /// @todo Create a "hardware address" class of which this will be a member.
  32. ///
  33. /// @param hwaddr Hardware address to convert to string form
  34. ///
  35. /// @return String form of the hardware address.
  36. std::string
  37. hardwareAddressString(const HWAddr& hwaddr);
  38. }; // namespace dhcp
  39. }; // namespace isc
  40. #endif // __HWADDR_H