Add an IDB option to hold an IANA tzdb timezone name.

Deprecate if_tzone, as it has never been specified, and, unless it were to somehow specify something such as an IANA tzdb timezone name, would be insufficient to allow conversion between UTC times in the file and local time.
IETF-OPSAWG-WG · Nov 22, 2023 · e63374c · e63374c
1 parent 59c5a11
commit e63374c
Showing 1 changed file with 20 additions and 3 deletions.
diff --git a/draft-ietf-opsawg-pcapng.md b/draft-ietf-opsawg-pcapng.md
@@ -980,6 +980,7 @@ the following options are valid within this block:
 | if_hardware | 15 | variable | no |
 | if_txspeed | 16 | 8 | no |
 | if_rxspeed | 17 | 8 | no |
+| if_iana_tzname | 18 | variable | no |
 {: #optionsifb title='Interface Description Block Options'}
 
 
@@ -1090,11 +1091,15 @@ Example: '6'.
 {: indent='8'}
 if_tzone:
 : The if_tzone
-  option identifies the time zone for GMT support (TODO: specify
-  better).
+  option identifies the time zone for GMT support.  This option has
+  never been specified in greater detail, and, unless it identifies
+  something such as an [IANA time zone database](https://www.iana.org/time-zones)
+  timezone, woudl be insufficient for converting between UTC and local
+  time, and SHOULD NOT be used.  Instead, the if_iana_tzname option
+  SHOULD be used if time zone information is to be specified.
 {: vspace='0'}
 
-Example: TODO: give a good example.
+Example: none
 
 
 {: indent='8'}
@@ -1200,6 +1205,18 @@ if the receive speed is unknown, the if_speed and if_rxspeed
 options MUST NOT be used.
 
 
+{: indent='8'}
+if_iana_tzname:
+: The if_iana_tzname
+  option is a UTF-8 string that indicates the [IANA time zone database](https://www.iana.org/time-zones)
+  timezone name for the IANA database timezone in which the interface
+  is located.
+{: vspace='0'}
+
+Examples: "Africa/Nairobi", "Asia/Kolkata", "America/Sao_Paulo",
+"Europe/Berlin".
+
+
 ## Enhanced Packet Block {#section_epb}
 
 An Enhanced Packet Block (EPB) is the standard container for