.\" intel-microcode2ucode stub man page
.\"
.\" SPDX-License-Identifier: CC0-1.0
.\"
.TH INTEL-MICROCODE2UCODE 8 "@DATE@" "MICROCODE_CTL @VERSION@"
.\"
.SH NAME
intel\-microcode2ucode \- convert Intel microcode.dat file into ucode files
.\"
.SH SYNOPSIS
.SY intel\-microcode2ucode
.RI [ MICROCODE_FILE ]
.YS
.\"
.SH DESCRIPTION
.B intel\-microcode2ucode
parses Intel microcode combined text data file (which usually has name
.BR microcode.dat )
and splits it into individual binary microcode files that can be loaded by the
Linux kernel.
.LP
Generated microcode files are placed into
.B intel-ucode
directory, which is created in the current working directory, and have file name
format of
.IR FF - MM - SS ,
where
.I FF
is the CPU family number,
.I MM
is the model number, and
.I SS
is stepping.
All three values are zero-filled to two digits and are hexadecimal
(letters are in the lower case).
.LP
This tool is mostly of historic interest, as Intel ships separate microcode
files now.
.\"
.SH OPTIONS
.\"
.TP
.I MICROCODE_FILE
Path to the
.B microcode.dat
file.
If no path has been provided, the default path
.B /lib/firmware/microcode.dat
is used.
If
.B -
(single dash) is provided as an argument, data is read from the standard input.
.\"
.SH EXIT STATUS
.TP
.B 0
Success.
.TP
.B 1
Error occurred:
temporary buffer cannot be allocated,
input microcode file cannot be opened,
microcode version and/or format are unknown,
cannot open output file,
cannot write to the output file.
.\"
.SH REPORTING BUGS
Problems with
.B intel-microcode2ucode
should be reported to
.UR https://bugzilla.redhat.com/
Red Hat Bugzilla
.UE
.\"
.SH AUTHORS
.B intel-microcode2ucode
was written by
Kay Sievers <kay.sievers@vrfy.org> and
Anton Arapov <anton@redhat.com>.
This manpage was written for Red Hat Enterprise Linux and may be
used, modified, and/or distributed freely by anyone.
.\"
.SH "SEE ALSO"
.UR https://gitlab.com\:/iucode-tool\:/iucode-tool
iucode-tool, a tool for manipulating Intel microcode files
.UE ,
.LP
.UR @MICROCODE_URL@
Intel microcode
.UE