@@ -6,9 +6,12 @@ module iana-display-hints {
6
6
import ietf-amm {
7
7
prefix amm;
8
8
}
9
+ import ietf-amm-base {
10
+ prefix amm-base;
11
+ }
9
12
10
13
organization
11
- "IANA" {
14
+ "Internet Assigned Numbers Authority ( IANA) " {
12
15
amm:enum 2 ;
13
16
}
14
17
contact
@@ -21,17 +24,17 @@ module iana-display-hints {
21
24
Tel: +1 310 301 5800
22
25
23
26
description
24
- "This module defines intermediate and leaf IDENT objects usable as
25
- display-hint annotations derived from the base
26
- <ari://ietf/amm/IDENT /display-hint> object.
27
+ "This module defines leaf IDENT objects usable as 'display-hint'
28
+ semantic type annotations derived from the base
29
+ <ari://ietf/amm-base/ident /display-hint> object.
27
30
28
31
The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL
29
32
NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'NOT RECOMMENDED',
30
33
'MAY', and 'OPTIONAL' in this document are to be interpreted as
31
34
described in BCP 14 (RFC 2119) (RFC 8174) when, and only when,
32
35
they appear in all capitals, as shown here.
33
36
34
- Copyright (c) 2024 IETF Trust and the persons identified as
37
+ Copyright (c) 2025 IETF Trust and the persons identified as
35
38
authors of the code. All rights reserved.
36
39
37
40
Redistribution and use in source and binary forms, with or
@@ -41,13 +44,13 @@ module iana-display-hints {
41
44
Relating to IETF Documents
42
45
(https://trustee.ietf.org/license-info).
43
46
44
- The initial version of this YANG module is part of RFC XXXX
47
+ This version of this YANG module is part of RFC XXXX
45
48
(https://www.rfc-editor.org/info/rfcXXXX); see the RFC itself
46
49
for full legal notices." ;
47
50
reference
48
51
"https://www.iana.org/assignments/DTNMA-TBA" ;
49
52
50
- revision 2025 -01 - 31 {
53
+ revision 2025 -07 - 03 {
51
54
description
52
55
"Updated for latest ADM document." ;
53
56
reference
@@ -56,138 +59,90 @@ module iana-display-hints {
56
59
amm:enum 0 ;
57
60
58
61
// Integer number hints
59
- amm:ident base-integer {
60
- amm:enum 1 ;
61
- description
62
- "Intermediate base IDENT of display hints for integer values.
63
- Hints derived from this object SHALL only apply to built-in types
64
- BYTE, INT, UINT, VAST, and UVAST." ;
65
- amm:base "//ietf/amm/IDENT/display-hint" ;
66
- }
67
62
amm:ident display-int-dec {
68
63
amm:enum 2 ;
69
64
description
70
65
"Display integers as decimal (base 10)." ;
71
- amm:base "//ietf/amm/IDENT/base -integer" ;
66
+ amm:base "//ietf/amm-base/ident/display-hint -integer" ;
72
67
}
73
68
amm:ident display-int-bin {
74
69
amm:enum 3 ;
75
70
description
76
71
"Display integers as binary (base 2)." ;
77
- amm:base "//ietf/amm/IDENT/base -integer" ;
72
+ amm:base "//ietf/amm-base/ident/display-hint -integer" ;
78
73
}
79
74
amm:ident display-int-hex {
80
75
amm:enum 4 ;
81
76
description
82
77
"Display integers as hexadecimal (base 16)." ;
83
- amm:base "//ietf/amm/IDENT/base -integer" ;
78
+ amm:base "//ietf/amm-base/ident/display-hint -integer" ;
84
79
}
85
80
86
81
// Floating-point number hints
87
- amm:ident base-float {
88
- amm:enum 5 ;
89
- description
90
- "Intermediate base IDENT of display hints for floating point values.
91
- Hints derived from this object SHALL only apply to built-in types
92
- REAL32 and REAL64." ;
93
- amm:base "//ietf/amm/IDENT/display-hint" ;
94
- }
95
82
amm:ident display-float-dec {
96
83
amm:enum 6 ;
97
84
description
98
85
"Display floating point values as decimal fraction." ;
99
- amm:base "//ietf/amm/IDENT/base -float" ;
86
+ amm:base "//ietf/amm-base/ident/display-hint -float" ;
100
87
}
101
88
amm:ident display-float-exp {
102
89
amm:enum 7 ;
103
90
description
104
91
"Display floating point values as decimal exponential form." ;
105
- amm:base "//ietf/amm/IDENT/base -float" ;
92
+ amm:base "//ietf/amm-base/ident/display-hint -float" ;
106
93
}
107
94
amm:ident display-float-hex {
108
95
amm:enum 8 ;
109
96
description
110
- "Display floating point values as hexadecimal exponential form." ;
111
- amm:base "//ietf/amm/IDENT/base-float" ;
97
+ "Display floating point values as hexadecimal exponential
98
+ form." ;
99
+ amm:base "//ietf/amm-base/ident/display-hint-float" ;
112
100
}
113
101
114
102
// Byte-string hints
115
- amm:ident base-bstr {
116
- amm:enum 9 ;
117
- description
118
- "Intermediate base IDENT of display hints for byte string values.
119
- Hints derived from this object SHALL only apply to built-in type
120
- BYTESTR." ;
121
- amm:base "//ietf/amm/IDENT/display-hint" ;
122
- }
123
103
amm:ident display-bstr-text {
124
104
amm:enum 10 ;
125
105
description
126
106
"Display byte string values as UTF-8 text where possible.
127
107
The base16 encoding is used otherwise." ;
128
108
reference
129
109
"draft-ietf-dtn-ari" ;
130
- amm:base "//ietf/amm/IDENT/base -bstr" ;
110
+ amm:base "//ietf/amm-base/ident/display-hint -bstr" ;
131
111
}
132
112
amm:ident display-bstr-base16 {
133
113
amm:enum 11 ;
134
114
description
135
115
"Display byte string values as base16-encoded." ;
136
116
reference
137
117
"draft-ietf-dtn-ari" ;
138
- amm:base "//ietf/amm/IDENT/base -bstr" ;
118
+ amm:base "//ietf/amm-base/ident/display-hint -bstr" ;
139
119
}
140
120
amm:ident display-bstr-base64 {
141
121
amm:enum 12 ;
142
122
description
143
123
"Display byte string values as base64url-encoded." ;
144
124
reference
145
125
"draft-ietf-dtn-ari" ;
146
- amm:base "//ietf/amm/IDENT/base-bstr" ;
147
- }
148
- amm:ident display-bstr-ipaddress {
149
- amm:enum 16 ;
150
- description
151
- "Interpret byte string values as either IPv4 address (4-octet length)
152
- or IPv6 address (16-octet length) and display as human-friendly text
153
- according to RFC 4001 conventions." ;
154
- reference
155
- "RFC 4001: Textual Conventions for Internet Network Addresses" ;
156
- amm:base "//ietf/amm/IDENT/base-bstr" ;
157
- }
158
- amm:ident display-bstr-uuid {
159
- amm:enum 17 ;
160
- description
161
- "Interpret byte string values as UUID and display as human-friendly text
162
- according to RFC 4122 conventions." ;
163
- reference
164
- "RFC 4122: A Universally Unique IDentifier (UUID) URN Namespace" ;
165
- amm:base "//ietf/amm/IDENT/base-bstr" ;
126
+ amm:base "//ietf/amm-base/ident/display-hint-bstr" ;
166
127
}
167
128
168
129
// TIME type (TP or TD built-ins) hints
169
- amm:ident base-time {
170
- amm:enum 13 ;
171
- description
172
- "Intermediate base IDENT of display hints for time values.
173
- Hints derived from this object SHALL only apply to built-in types
174
- TP and TD." ;
175
- amm:base "//ietf/amm/IDENT/display-hint" ;
176
- }
177
130
amm:ident display-time-text {
178
131
amm:enum 14 ;
179
132
description
180
- "Display TP and TD values as text in accordance with RFC 3339." ;
133
+ "Display TP and TD values as text in accordance with
134
+ RFC 3339 not using separator characters." ;
181
135
reference
182
136
"draft-ietf-dtn-ari" ;
183
- amm:base "//ietf/amm/IDENT/base -time" ;
137
+ amm:base "//ietf/amm-base/ident/display-hint -time" ;
184
138
}
185
139
amm:ident display-time-dec {
186
140
amm:enum 15 ;
187
141
description
188
- "Display TP and TD values as decimal fraction." ;
142
+ "Display TP and TD values as decimal fraction with units of
143
+ seconds, which may or may not include a fractional part." ;
189
144
reference
190
145
"draft-ietf-dtn-ari" ;
191
- amm:base "//ietf/amm/IDENT/base -time" ;
146
+ amm:base "//ietf/amm-base/ident/display-hint -time" ;
192
147
}
193
148
}
0 commit comments