|
|
|
# Overview
|
|
|
|
|
|
|
|
This page gives guidance to CR authors who need to put examples of identifiers or other values in their contributions.
|
|
|
|
|
|
|
|
It is important to avoid using identifiers which may be publically assigned or routable.
|
|
|
|
|
|
|
|
In the examples, the numeric placeholder value convention is:
|
|
|
|
| Placeholder | Description |
|
|
|
|
|-------------|-------------|
|
|
|
|
| `m` | Decimal number |
|
|
|
|
| `n` | Decimal number |
|
|
|
|
| `x` | Hexadecimal number |
|
|
|
|
|
|
|
|
# DNS name (including email address domains)
|
|
|
|
|
|
|
|
[RFC 2606 section 2](https://datatracker.ietf.org/doc/html/rfc2606#section-2) reserves four top level domains for test and documentation purposes:
|
|
|
|
|
|
|
|
* `.test`
|
|
|
|
* `.example`
|
|
|
|
* `.invalid`
|
|
|
|
* `.localhost`
|
|
|
|
|
|
|
|
[RFC 2606 section 3](https://datatracker.ietf.org/doc/html/rfc2606#section-3) also states that IANA reserves the following second level domain names for example and documentation purposes:
|
|
|
|
|
|
|
|
* `.example.com`
|
|
|
|
* `.example.net`
|
|
|
|
* `.example.org`
|
|
|
|
|
|
|
|
Any of the above domains can be used, although we recommend using the `.example....` second level domains.
|
|
|
|
|
|
|
|
Examples:
|
|
|
|
|
|
|
|
* `user@example.com`
|
|
|
|
* `sip:user@example.com`
|
|
|
|
|
|
|
|
References:
|
|
|
|
|
|
|
|
* [IETF RFC 2606 - Reserved Top Level DNS Names](https://tools.ietf.org/html/rfc2606)
|
|
|
|
* [IETF RFC 6761 - Special-Use Domain Names](https://tools.ietf.org/html/rfc6761)
|
|
|
|
|
|
|
|
# EUI-64
|
|
|
|
|
|
|
|
Examples:
|
|
|
|
| EUI-64 range | Description |
|
|
|
|
|--------------|-------------|
|
|
|
|
| `00:00:5e:ef:10:00:00:xx` | Unicast, general |
|
|
|
|
| `00:00:5e:ff:fe:00:53:xx` | EUI-48 (MAC address) derived |
|
|
|
|
| `01:00:5e:ff:fe:90:10:xx` | Multicast, general |
|
|
|
|
| `02:00:5e:10:00:00:00:xx` | Modified EUI-48, for IPv6 from EUI-48 MAC address |
|
|
|
|
|
|
|
|
**Note**: Our preference is to use lower-case (not upper-case) hexadecimal, and colon (not dash) separators.
|
|
|
|
|
|
|
|
References:
|
|
|
|
|
|
|
|
* [IETF RFC 7042 - IANA Considerations and IETF Protocol and Documentation Usage for IEEE 802 Parameters section 2.2.3](https://tools.ietf.org/html/rfc7042)
|
|
|
|
|
|
|
|
# IMEI
|
|
|
|
|
|
|
|
We don't have a solution here yet. Research notes:
|
|
|
|
|
|
|
|
* An IMEI is broken up into TAC + Serial.
|
|
|
|
* The first 2 digits of the TAC is the "Reporting Body Identifier" (RBI).
|
|
|
|
* RBIs are managed by GSMA, per GSMA TS.06.
|
|
|
|
* There are test RBIs, and we could see if there's a reserved value for documentation.
|
|
|
|
|
|
|
|
E.g., See "00 44" in GSMA TS.06 annex B, allocated by John Talbot @ TUV SUD.
|
|
|
|
|
|
|
|
References:
|
|
|
|
|
|
|
|
* [International Mobile Equipment Identity](https://en.wikipedia.org/wiki/International_Mobile_Equipment_Identity)
|
|
|
|
* [Type Allocation Code](https://en.wikipedia.org/wiki/Type_Allocation_Code)
|
|
|
|
* [Reporting Body Identifier](https://en.wikipedia.org/wiki/Reporting_Body_Identifier)
|
|
|
|
* [GSMA TS.06 IMEI allocation and approval process annexes A and B](https://www.gsma.com/newsroom/resources/ts-06-imei-allocation-and-approval-process-2/)
|
|
|
|
|
|
|
|
# IMSI
|
|
|
|
|
|
|
|
ETSI TS 123 003 clause 2.2 describes the IMSI as up to 15 digits:
|
|
|
|
|
|
|
|
* 3 digits Mobile Country Code (MCC)
|
|
|
|
* 2-3 digits Mobile Network Code (MNC)
|
|
|
|
* 9-10 digits Mobile Subscriber Identification Number (MSIN)
|
|
|
|
|
|
|
|
Allocate IMSIs with the leading 5-6 digits per [Mobile Country Code (MCC) and Mobile Network Code (MNC)](#mobile-country-code-mcc-and-mobile-network-code-mnc). The remaining 9-10 digits of MSIN may be any digits.
|
|
|
|
|
|
|
|
References:
|
|
|
|
|
|
|
|
* [Mobile Country Code (MCC) and Mobile Network Code (MNC)](#mobile-country-code-mcc-and-mobile-network-code-mnc)
|
|
|
|
* [ETSI TS 123 003: "Numbering, addressing and identification (3GPP TS 23.003)"](https://www.etsi.org/deliver/etsi_ts/123000_123099/123003/)
|
|
|
|
|
|
|
|
# IPv4 address/prefix
|
|
|
|
|
|
|
|
Examples:
|
|
|
|
| IPv4 prefix | Description |
|
|
|
|
|-------------|-------------|
|
|
|
|
| `192.0.2.0/24` | TEST-NET-1 |
|
|
|
|
| `198.51.100.0/24` | TEST-NET-2 |
|
|
|
|
| `203.0.113.0/24` | TEST-NET-3 |
|
|
|
|
|
|
|
|
Use IPv4 addresses from these prefixes.
|
|
|
|
|
|
|
|
References:
|
|
|
|
|
|
|
|
* [IETF RFC 5737 - IPv4 Address Blocks Reserved for Documentation](https://tools.ietf.org/html/rfc5737)
|
|
|
|
|
|
|
|
# IPv6 address/prefix
|
|
|
|
|
|
|
|
Examples:
|
|
|
|
| IPv6 prefix | Description |
|
|
|
|
|-------------|-------------|
|
|
|
|
| `2001:DB8::/32` | IPv6 prefix allocated for documentation purposes |
|
|
|
|
|
|
|
|
Use IPv6 addresses from these prefixes.
|
|
|
|
|
|
|
|
For the lower 64 bits of an IPv6 address, if using an modified EUI-64 derived from a MAC address, see [EUI-64](#eui-64).
|
|
|
|
|
|
|
|
References:
|
|
|
|
|
|
|
|
* [IETF RFC 3849 - IPv6 Address Prefix Reserved for Documentation](https://tools.ietf.org/html/rfc3849)
|
|
|
|
|
|
|
|
# MAC address (EUI-48)
|
|
|
|
|
|
|
|
Examples:
|
|
|
|
| MAC address range | Description |
|
|
|
|
|-------------------|-------------|
|
|
|
|
| `00:00:5e:00:53:xx` | Unicast |
|
|
|
|
| `01:00:5e:90:10:xx` | Multicast |
|
|
|
|
|
|
|
|
**Note**: Our preference is to use lower-case (not upper-case) hexadecimal, and colon (not dash) separators.
|
|
|
|
|
|
|
|
References:
|
|
|
|
|
|
|
|
* [IETF RFC 7042 - IANA Considerations and IETF Protocol and Documentation Usage for IEEE 802 Parameters section 2.1.2](https://tools.ietf.org/html/rfc7042)
|
|
|
|
|
|
|
|
# Mobile Country Code (MCC) and Mobile Network Code (MNC)
|
|
|
|
|
|
|
|
The combination of the MCC and MNC is often referred to as the PLMN, and is used as the first 5-6 digits of an [IMSI](#imsi).
|
|
|
|
|
|
|
|
Examples:
|
|
|
|
| MCC | MNC | Description |
|
|
|
|
|-----|-----|-------------|
|
|
|
|
| `001` | `01` | Test network (unofficial ?) |
|
|
|
|
| `001` | `001` | Test network (unofficial ?) |
|
|
|
|
| `999` | `99` | Internal use |
|
|
|
|
| `999` | `999` | Internal use |
|
|
|
|
|
|
|
|
References:
|
|
|
|
|
|
|
|
* [Mobile Country Code](https://en.wikipedia.org/wiki/Mobile_country_code)
|
|
|
|
* [ITU Operational Bulletin No. 1156](https://www.itu.int/pub/T-SP-OB.1156-2018)
|
|
|
|
|
|
|
|
# Phone numbers
|
|
|
|
|
|
|
|
Various countries allocate "drama" or "fiction" ranges - see the references.
|
|
|
|
|
|
|
|
ITU E.164 doesn't appear to have any reserved dialing codes for test or example purposes, but does give a list of reserved and spare codes.
|
|
|
|
|
|
|
|
Examples:
|
|
|
|
| E.164 range | Description |
|
|
|
|
|-------------|-------------|
|
|
|
|
| `1 mmm 555 01nn` | US,CA: geographic area for area prefix `mmm` |
|
|
|
|
| `33 1 99 00 nn nn` | FR: Île-de-France / Paris (TBC) |
|
|
|
|
| `33 6 39 98 nn nn` | FR: mobile services (TBC) |
|
|
|
|
| `44 1632 960 nnn` | UK: no geographic area |
|
|
|
|
| `44 20 7946 0nnn` | UK: London |
|
|
|
|
| `44 7700 900 nnn` | UK: mobile services |
|
|
|
|
| `49 171 39200 nn` | DE: mobile services |
|
|
|
|
| `49 176 040690 nn` | DE: mobile services |
|
|
|
|
| `49 30 23 125 nnn` | DE: Berlin |
|
|
|
|
| `61 2 5550 nnn` | AU: Canberra |
|
|
|
|
| `61 491 570 006` | AU: mobile service. Other numbers with various prefixes available. |
|
|
|
|
|
|
|
|
References:
|
|
|
|
|
|
|
|
* [ITU E.164 dialling code bulleting](https://www.itu.int/dms_pub/itu-t/opb/sp/T-SP-E.164D-2016-PDF-E.pdf)
|
|
|
|
* [AU: Choose your phone number](https://www.acma.gov.au/choose-your-phone-number#use-phone-numbers-for-fiction)
|
|
|
|
* [DE: Rufnummern für Medienproduktionen („Drama Numbers“) (_Numbers for media productions ("Drama Numbers")_) (pdf)](https://www.bundesnetzagentur.de/SharedDocs/Downloads/DE/Sachgebiete/Telekommunikation/Unternehmen_Institutionen/Nummerierung/Rufnummern/Mittlg148_2021.pdf?__blob=publicationFile&v=1)
|
|
|
|
* [FR: Décision n°2018-0881 modifiée de l'Autorité de régulation des communications électroniques et des postes en date du 24 juillet 2018 établissant le plan national de numérotation et ses règles de gestion (pdf)](https://www.arcep.fr/uploads/tx_gsavis/18-0881.pdf)
|
|
|
|
* [UK: OFCOM Numbers for drama](https://www.ofcom.org.uk/phones-telecoms-and-internet/information-for-industry/numbering/numbers-for-drama)
|
|
|
|
* [US: 555 NXX Line Number Reference Document (pdf)](https://www.nationalnanpa.com/pdf/NRUF/ATIS-0300115.pdf)
|
|
|
|
* Wikipedia: [List of country calling codes](https://en.wikipedia.org/wiki/List_of_country_calling_codes)
|
|
|
|
* Wikipedia: [Fictitious telephone number](https://en.wikipedia.org/wiki/Fictitious_telephone_number) |
|
|
|
\ No newline at end of file |