if_macsec.h 5.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178
  1. /* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */
  2. /*
  3. * include/uapi/linux/if_macsec.h - MACsec device
  4. *
  5. * Copyright (c) 2015 Sabrina Dubroca <sd@queasysnail.net>
  6. *
  7. * This program is free software; you can redistribute it and/or modify
  8. * it under the terms of the GNU General Public License as published by
  9. * the Free Software Foundation; either version 2 of the License, or
  10. * (at your option) any later version.
  11. */
  12. #ifndef _UAPI_MACSEC_H
  13. #define _UAPI_MACSEC_H
  14. #include <linux/types.h>
  15. #define MACSEC_GENL_NAME "macsec"
  16. #define MACSEC_GENL_VERSION 1
  17. #define MACSEC_MAX_KEY_LEN 128
  18. #define MACSEC_KEYID_LEN 16
  19. /* cipher IDs as per IEEE802.1AEbn-2011 */
  20. #define MACSEC_CIPHER_ID_GCM_AES_128 0x0080C20001000001ULL
  21. #define MACSEC_CIPHER_ID_GCM_AES_256 0x0080C20001000002ULL
  22. /* deprecated cipher ID for GCM-AES-128 */
  23. #define MACSEC_DEFAULT_CIPHER_ID 0x0080020001000001ULL
  24. #define MACSEC_DEFAULT_CIPHER_ALT MACSEC_CIPHER_ID_GCM_AES_128
  25. #define MACSEC_MIN_ICV_LEN 8
  26. #define MACSEC_MAX_ICV_LEN 32
  27. /* upper limit for ICV length as recommended by IEEE802.1AE-2006 */
  28. #define MACSEC_STD_ICV_LEN 16
  29. enum macsec_attrs {
  30. MACSEC_ATTR_UNSPEC,
  31. MACSEC_ATTR_IFINDEX, /* u32, ifindex of the MACsec netdevice */
  32. MACSEC_ATTR_RXSC_CONFIG, /* config, nested macsec_rxsc_attrs */
  33. MACSEC_ATTR_SA_CONFIG, /* config, nested macsec_sa_attrs */
  34. MACSEC_ATTR_SECY, /* dump, nested macsec_secy_attrs */
  35. MACSEC_ATTR_TXSA_LIST, /* dump, nested, macsec_sa_attrs for each TXSA */
  36. MACSEC_ATTR_RXSC_LIST, /* dump, nested, macsec_rxsc_attrs for each RXSC */
  37. MACSEC_ATTR_TXSC_STATS, /* dump, nested, macsec_txsc_stats_attr */
  38. MACSEC_ATTR_SECY_STATS, /* dump, nested, macsec_secy_stats_attr */
  39. __MACSEC_ATTR_END,
  40. NUM_MACSEC_ATTR = __MACSEC_ATTR_END,
  41. MACSEC_ATTR_MAX = __MACSEC_ATTR_END - 1,
  42. };
  43. enum macsec_secy_attrs {
  44. MACSEC_SECY_ATTR_UNSPEC,
  45. MACSEC_SECY_ATTR_SCI,
  46. MACSEC_SECY_ATTR_ENCODING_SA,
  47. MACSEC_SECY_ATTR_WINDOW,
  48. MACSEC_SECY_ATTR_CIPHER_SUITE,
  49. MACSEC_SECY_ATTR_ICV_LEN,
  50. MACSEC_SECY_ATTR_PROTECT,
  51. MACSEC_SECY_ATTR_REPLAY,
  52. MACSEC_SECY_ATTR_OPER,
  53. MACSEC_SECY_ATTR_VALIDATE,
  54. MACSEC_SECY_ATTR_ENCRYPT,
  55. MACSEC_SECY_ATTR_INC_SCI,
  56. MACSEC_SECY_ATTR_ES,
  57. MACSEC_SECY_ATTR_SCB,
  58. MACSEC_SECY_ATTR_PAD,
  59. __MACSEC_SECY_ATTR_END,
  60. NUM_MACSEC_SECY_ATTR = __MACSEC_SECY_ATTR_END,
  61. MACSEC_SECY_ATTR_MAX = __MACSEC_SECY_ATTR_END - 1,
  62. };
  63. enum macsec_rxsc_attrs {
  64. MACSEC_RXSC_ATTR_UNSPEC,
  65. MACSEC_RXSC_ATTR_SCI, /* config/dump, u64 */
  66. MACSEC_RXSC_ATTR_ACTIVE, /* config/dump, u8 0..1 */
  67. MACSEC_RXSC_ATTR_SA_LIST, /* dump, nested */
  68. MACSEC_RXSC_ATTR_STATS, /* dump, nested, macsec_rxsc_stats_attr */
  69. MACSEC_RXSC_ATTR_PAD,
  70. __MACSEC_RXSC_ATTR_END,
  71. NUM_MACSEC_RXSC_ATTR = __MACSEC_RXSC_ATTR_END,
  72. MACSEC_RXSC_ATTR_MAX = __MACSEC_RXSC_ATTR_END - 1,
  73. };
  74. enum macsec_sa_attrs {
  75. MACSEC_SA_ATTR_UNSPEC,
  76. MACSEC_SA_ATTR_AN, /* config/dump, u8 0..3 */
  77. MACSEC_SA_ATTR_ACTIVE, /* config/dump, u8 0..1 */
  78. MACSEC_SA_ATTR_PN, /* config/dump, u32 */
  79. MACSEC_SA_ATTR_KEY, /* config, data */
  80. MACSEC_SA_ATTR_KEYID, /* config/dump, 128-bit */
  81. MACSEC_SA_ATTR_STATS, /* dump, nested, macsec_sa_stats_attr */
  82. MACSEC_SA_ATTR_PAD,
  83. __MACSEC_SA_ATTR_END,
  84. NUM_MACSEC_SA_ATTR = __MACSEC_SA_ATTR_END,
  85. MACSEC_SA_ATTR_MAX = __MACSEC_SA_ATTR_END - 1,
  86. };
  87. enum macsec_nl_commands {
  88. MACSEC_CMD_GET_TXSC,
  89. MACSEC_CMD_ADD_RXSC,
  90. MACSEC_CMD_DEL_RXSC,
  91. MACSEC_CMD_UPD_RXSC,
  92. MACSEC_CMD_ADD_TXSA,
  93. MACSEC_CMD_DEL_TXSA,
  94. MACSEC_CMD_UPD_TXSA,
  95. MACSEC_CMD_ADD_RXSA,
  96. MACSEC_CMD_DEL_RXSA,
  97. MACSEC_CMD_UPD_RXSA,
  98. };
  99. /* u64 per-RXSC stats */
  100. enum macsec_rxsc_stats_attr {
  101. MACSEC_RXSC_STATS_ATTR_UNSPEC,
  102. MACSEC_RXSC_STATS_ATTR_IN_OCTETS_VALIDATED,
  103. MACSEC_RXSC_STATS_ATTR_IN_OCTETS_DECRYPTED,
  104. MACSEC_RXSC_STATS_ATTR_IN_PKTS_UNCHECKED,
  105. MACSEC_RXSC_STATS_ATTR_IN_PKTS_DELAYED,
  106. MACSEC_RXSC_STATS_ATTR_IN_PKTS_OK,
  107. MACSEC_RXSC_STATS_ATTR_IN_PKTS_INVALID,
  108. MACSEC_RXSC_STATS_ATTR_IN_PKTS_LATE,
  109. MACSEC_RXSC_STATS_ATTR_IN_PKTS_NOT_VALID,
  110. MACSEC_RXSC_STATS_ATTR_IN_PKTS_NOT_USING_SA,
  111. MACSEC_RXSC_STATS_ATTR_IN_PKTS_UNUSED_SA,
  112. MACSEC_RXSC_STATS_ATTR_PAD,
  113. __MACSEC_RXSC_STATS_ATTR_END,
  114. NUM_MACSEC_RXSC_STATS_ATTR = __MACSEC_RXSC_STATS_ATTR_END,
  115. MACSEC_RXSC_STATS_ATTR_MAX = __MACSEC_RXSC_STATS_ATTR_END - 1,
  116. };
  117. /* u32 per-{RX,TX}SA stats */
  118. enum macsec_sa_stats_attr {
  119. MACSEC_SA_STATS_ATTR_UNSPEC,
  120. MACSEC_SA_STATS_ATTR_IN_PKTS_OK,
  121. MACSEC_SA_STATS_ATTR_IN_PKTS_INVALID,
  122. MACSEC_SA_STATS_ATTR_IN_PKTS_NOT_VALID,
  123. MACSEC_SA_STATS_ATTR_IN_PKTS_NOT_USING_SA,
  124. MACSEC_SA_STATS_ATTR_IN_PKTS_UNUSED_SA,
  125. MACSEC_SA_STATS_ATTR_OUT_PKTS_PROTECTED,
  126. MACSEC_SA_STATS_ATTR_OUT_PKTS_ENCRYPTED,
  127. __MACSEC_SA_STATS_ATTR_END,
  128. NUM_MACSEC_SA_STATS_ATTR = __MACSEC_SA_STATS_ATTR_END,
  129. MACSEC_SA_STATS_ATTR_MAX = __MACSEC_SA_STATS_ATTR_END - 1,
  130. };
  131. /* u64 per-TXSC stats */
  132. enum macsec_txsc_stats_attr {
  133. MACSEC_TXSC_STATS_ATTR_UNSPEC,
  134. MACSEC_TXSC_STATS_ATTR_OUT_PKTS_PROTECTED,
  135. MACSEC_TXSC_STATS_ATTR_OUT_PKTS_ENCRYPTED,
  136. MACSEC_TXSC_STATS_ATTR_OUT_OCTETS_PROTECTED,
  137. MACSEC_TXSC_STATS_ATTR_OUT_OCTETS_ENCRYPTED,
  138. MACSEC_TXSC_STATS_ATTR_PAD,
  139. __MACSEC_TXSC_STATS_ATTR_END,
  140. NUM_MACSEC_TXSC_STATS_ATTR = __MACSEC_TXSC_STATS_ATTR_END,
  141. MACSEC_TXSC_STATS_ATTR_MAX = __MACSEC_TXSC_STATS_ATTR_END - 1,
  142. };
  143. /* u64 per-SecY stats */
  144. enum macsec_secy_stats_attr {
  145. MACSEC_SECY_STATS_ATTR_UNSPEC,
  146. MACSEC_SECY_STATS_ATTR_OUT_PKTS_UNTAGGED,
  147. MACSEC_SECY_STATS_ATTR_IN_PKTS_UNTAGGED,
  148. MACSEC_SECY_STATS_ATTR_OUT_PKTS_TOO_LONG,
  149. MACSEC_SECY_STATS_ATTR_IN_PKTS_NO_TAG,
  150. MACSEC_SECY_STATS_ATTR_IN_PKTS_BAD_TAG,
  151. MACSEC_SECY_STATS_ATTR_IN_PKTS_UNKNOWN_SCI,
  152. MACSEC_SECY_STATS_ATTR_IN_PKTS_NO_SCI,
  153. MACSEC_SECY_STATS_ATTR_IN_PKTS_OVERRUN,
  154. MACSEC_SECY_STATS_ATTR_PAD,
  155. __MACSEC_SECY_STATS_ATTR_END,
  156. NUM_MACSEC_SECY_STATS_ATTR = __MACSEC_SECY_STATS_ATTR_END,
  157. MACSEC_SECY_STATS_ATTR_MAX = __MACSEC_SECY_STATS_ATTR_END - 1,
  158. };
  159. #endif /* _UAPI_MACSEC_H */