(formatting) |
(more formatting) |
||
| Line 65: | Line 65: | ||
== Short forms == | == Short forms == | ||
No short form for any field except $ARCH for any image may exceed four characters in length, including underscores. | No short form for any field except '''$ARCH''' for any image may exceed four characters in length, including underscores. | ||
=== $PRODUCT(_SUBPRODUCT) === | === $PRODUCT(_SUBPRODUCT) === | ||
| Line 115: | Line 115: | ||
* Final: F | * Final: F | ||
The short form of the test compose identifier | The short form of the test compose identifier '''TC''' is '''T'''; the number component is not be changed. e.g. '''TC1''' -> '''T1'''. | ||
e.g. | e.g. | ||
* 21_Alpha_TC1 shortens to 21_A_T1 | * '''21_Alpha_TC1''' shortens to '''21_A_T1''' | ||
* 22_Beta shortens to 22_B | * '''22_Beta''' shortens to '''22_B''' | ||
=== $DATE === | === $DATE === | ||
The $DATE field is omitted entirely when short forms are in use (i.e. when generating volume IDs for ISO 9660 images). | The '''$DATE''' field is omitted entirely when short forms are in use (i.e. when generating volume IDs for ISO 9660 images). | ||
== Examples == | == Examples == | ||
Revision as of 21:54, 24 July 2014
Summary
Fedora images are named according to this scheme:
Fedora-{$PRODUCT(_SUBPRODUCT),$LOADOUT}-$IMAGETYPE-$ARCH-$VERSION(-$DATE)
Fields may only contain ASCII alphanumeric characters and underscores. Particularly of note, the character '-' is reserved for use as a field separator. No field may itself contain that character.
Any image that forms part of a Fedora release, pre-release, test compose or release candidate build must contain "Fedora" as the first field, *either* $PRODUCT(_SUBPRODUCT) *or* $LOADOUT as the second field, and the fields $IMAGETYPE, $ARCH, and $VERSION as the third, fourth and fifth fields of its name.
Standard short forms of each field (except "Fedora"), for the purpose of producing <= 32 character volume IDs for ISO 9660 images, are defined below. Image filenames will use the full-length field values, ISO 9660 image volume IDs will use the shortened values.
Fields
$PRODUCT(_SUBPRODUCT)
The second field for images that are part of a Fedora Product will be the name of that product. If the Product produces multiple image 'flavors', here referred to as subproducts, the subproduct is appended after an underscore. The content of this field prior to the first underscore must exactly match the name of a Fedora Product. e.g.:
- Server
- Workstation
- Cloud_Base
- Cloud_Big_Data
$LOADOUT
The second field for images that are not part of a Fedora Product will be the image's 'loadout', a descriptor for the software content of the image. This will usually be the name of a desktop or a live spin. e.g.:
- KDE
- Minimal
- Scientific_KDE
- Electronic_Lab
$IMAGETYPE
The third field for all images will be a descriptor of the image's type - live image, network install image, offline install image, disk image, etc. e.g.:
- Live
- netinst
- DVD
- Disk (or Image)
$ARCH
The fourth field for all images will be the architecture of the image, defined as the yum basearch used in composing that image. e.g.
- i686
- x86_64
- armhfp
$VERSION
The fifth field for all images will be the version of the image. At minimum this will be the release number. The milestone and test compose number may be appended with underscores if appropriate (release candidate numbers are never included; release candidate images are named as if they were release images). e.g.
- 21
- 21_Alpha
- 21_Beta_TC1
- 21_Final_TC2
$DATE
The date of the compose, in YYYYMMDD form, may optionally be appended as a sixth field for a given compose run. e.g.
- 20140724
Short forms
No short form for any field except $ARCH for any image may exceed four characters in length, including underscores.
$PRODUCT(_SUBPRODUCT)
The short forms of the Fedora Products are as follows:
- Workstation: WS
- Cloud: C
- Server: S
Subproduct short forms may be determined by the product working group and release engineering. As noted above, they may not exceed four total characters.
$LOADOUT
The short forms of currently-used 'loadouts' are as follows:
- Minimal: Min
- KDE: KDE
- LXDE: LXDE
- MATE-Compiz: MATE
- SoaS: SoaS
- Xfce: Xfce
- Electronic_Lab: Elec
- Robotics: Robo
- Games: Game
- Jam_KDE: Jam
- Scientific_KDE: SciK
- Security: Sec
$IMAGETYPE
The short forms of currently-used 'image types' are as follows:
- Live: Live
- DVD: DVD
- netinst: net
- Disk: Disk
$ARCH
The full forms of all currently-used architectures are used as the short forms.
$VERSION
The full form of the release number is used as the short form. The short forms of milestone identifiers are as follows:
- Alpha: A
- Beta: B
- Final: F
The short form of the test compose identifier TC is T; the number component is not be changed. e.g. TC1 -> T1.
e.g.
- 21_Alpha_TC1 shortens to 21_A_T1
- 22_Beta shortens to 22_B
$DATE
The $DATE field is omitted entirely when short forms are in use (i.e. when generating volume IDs for ISO 9660 images).
Examples
- Filename:
Fedora-Workstation-Live-x86_64-21_Alpha_TC1.iso - Volume ID:
Fedora-WS-Live-x86_64-21_A_T1(29 char)
- Filename:
Fedora-Scientific_KDE-Live-x86_64-22_Beta_TC2.iso - Volume ID:
Fedora-SciK-Live-x86_64-21-B_T2(31 char)
- Filename:
Fedora-Server-netinst-i686-23.iso - Volume ID:
Fedora-S-net-i686-23(20 char)
- Filename:
Fedora-MATE_Compiz-Disk-armhfp-24_Final_TC3.raw.xz - Volume ID: N/A (disk images do not have them)