* [PATCH 1/1] doc: rework doc/mkeficapsule.1
@ 2023-01-23 11:23 Heinrich Schuchardt
2023-01-23 18:42 ` Simon Glass
0 siblings, 1 reply; 4+ messages in thread
From: Heinrich Schuchardt @ 2023-01-23 11:23 UTC (permalink / raw)
To: Ilias Apalodimas; +Cc: u-boot, Heinrich Schuchardt
* Indicate the location of the directory for EFI capsules.
* Improve the readability.
Signed-off-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>
---
doc/mkeficapsule.1 | 21 +++++++++++----------
1 file changed, 11 insertions(+), 10 deletions(-)
diff --git a/doc/mkeficapsule.1 b/doc/mkeficapsule.1
index 6fb2dd0810..1ca245a10f 100644
--- a/doc/mkeficapsule.1
+++ b/doc/mkeficapsule.1
@@ -11,22 +11,23 @@ mkeficapsule \- Generate EFI capsule file for U-Boot
.RI [ options ] " " [ image-blob ] " " capsule-file
.SH "DESCRIPTION"
+The
.B mkeficapsule
-command is used to create an EFI capsule file for use with the U-Boot
-EFI capsule update.
-A capsule file may contain various type of firmware blobs which
-are to be applied to the system and must be placed in the specific
-directory on the UEFI system partition.
-An update will be automatically executed at next reboot.
+command is used to create an EFI capsule file to be used by U-Boot for firmware
+updates.
+A capsule file may contain various types of firmware blobs which are to be
+applied to the system.
+If a capsule file is placed in the /EFI/CapusuleUpdate directory of the EFI
+system partition, U-Boot will try to execute the update at the next reboot.
Optionally, a capsule file can be signed with a given private key.
In this case, the update will be authenticated by verifying the signature
before applying.
-Additionally, an empty capsule file can be generated for acceptance or
-rejection of firmware images by a governing component like an Operating
-System. The empty capsules do not require an image-blob input file.
-
+Additionally, an empty capsule file can be generated to indicate the acceptance
+or rejection of firmware images by a governing component like an operating
+system.
+Empty capsules do not require an image-blob input file.
.B mkeficapsule
takes any type of image files when generating non empty capsules, including:
--
2.38.1
^ permalink raw reply related [flat|nested] 4+ messages in thread
* Re: [PATCH 1/1] doc: rework doc/mkeficapsule.1
2023-01-23 11:23 [PATCH 1/1] doc: rework doc/mkeficapsule.1 Heinrich Schuchardt
@ 2023-01-23 18:42 ` Simon Glass
2023-01-23 18:50 ` Heinrich Schuchardt
0 siblings, 1 reply; 4+ messages in thread
From: Simon Glass @ 2023-01-23 18:42 UTC (permalink / raw)
To: Heinrich Schuchardt; +Cc: Ilias Apalodimas, u-boot
Hi Heinrich,
On Mon, 23 Jan 2023 at 04:24, Heinrich Schuchardt
<heinrich.schuchardt@canonical.com> wrote:
>
> * Indicate the location of the directory for EFI capsules.
> * Improve the readability.
>
> Signed-off-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>
> ---
> doc/mkeficapsule.1 | 21 +++++++++++----------
> 1 file changed, 11 insertions(+), 10 deletions(-)
>
> diff --git a/doc/mkeficapsule.1 b/doc/mkeficapsule.1
> index 6fb2dd0810..1ca245a10f 100644
> --- a/doc/mkeficapsule.1
> +++ b/doc/mkeficapsule.1
> @@ -11,22 +11,23 @@ mkeficapsule \- Generate EFI capsule file for U-Boot
> .RI [ options ] " " [ image-blob ] " " capsule-file
>
> .SH "DESCRIPTION"
> +The
> .B mkeficapsule
> -command is used to create an EFI capsule file for use with the U-Boot
> -EFI capsule update.
> -A capsule file may contain various type of firmware blobs which
> -are to be applied to the system and must be placed in the specific
> -directory on the UEFI system partition.
> -An update will be automatically executed at next reboot.
> +command is used to create an EFI capsule file to be used by U-Boot for firmware
> +updates.
> +A capsule file may contain various types of firmware blobs which are to be
> +applied to the system.
> +If a capsule file is placed in the /EFI/CapusuleUpdate directory of the EFI
> +system partition, U-Boot will try to execute the update at the next reboot.
>
> Optionally, a capsule file can be signed with a given private key.
> In this case, the update will be authenticated by verifying the signature
> before applying.
>
> -Additionally, an empty capsule file can be generated for acceptance or
> -rejection of firmware images by a governing component like an Operating
> -System. The empty capsules do not require an image-blob input file.
> -
> +Additionally, an empty capsule file can be generated to indicate the acceptance
> +or rejection of firmware images by a governing component like an operating
> +system.
> +Empty capsules do not require an image-blob input file.
>
> .B mkeficapsule
> takes any type of image files when generating non empty capsules, including:
> --
> 2.38.1
>
BTW as someone else mentioned, this functionality should be in binman too.
Regards,
Simon
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH 1/1] doc: rework doc/mkeficapsule.1
2023-01-23 18:42 ` Simon Glass
@ 2023-01-23 18:50 ` Heinrich Schuchardt
2023-01-23 22:25 ` Simon Glass
0 siblings, 1 reply; 4+ messages in thread
From: Heinrich Schuchardt @ 2023-01-23 18:50 UTC (permalink / raw)
To: Simon Glass; +Cc: Ilias Apalodimas, u-boot
On 1/23/23 19:42, Simon Glass wrote:
> Hi Heinrich,
>
> On Mon, 23 Jan 2023 at 04:24, Heinrich Schuchardt
> <heinrich.schuchardt@canonical.com> wrote:
>>
>> * Indicate the location of the directory for EFI capsules.
>> * Improve the readability.
>>
>> Signed-off-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>
>> ---
>> doc/mkeficapsule.1 | 21 +++++++++++----------
>> 1 file changed, 11 insertions(+), 10 deletions(-)
>>
>> diff --git a/doc/mkeficapsule.1 b/doc/mkeficapsule.1
>> index 6fb2dd0810..1ca245a10f 100644
>> --- a/doc/mkeficapsule.1
>> +++ b/doc/mkeficapsule.1
>> @@ -11,22 +11,23 @@ mkeficapsule \- Generate EFI capsule file for U-Boot
>> .RI [ options ] " " [ image-blob ] " " capsule-file
>>
>> .SH "DESCRIPTION"
>> +The
>> .B mkeficapsule
>> -command is used to create an EFI capsule file for use with the U-Boot
>> -EFI capsule update.
>> -A capsule file may contain various type of firmware blobs which
>> -are to be applied to the system and must be placed in the specific
>> -directory on the UEFI system partition.
>> -An update will be automatically executed at next reboot.
>> +command is used to create an EFI capsule file to be used by U-Boot for firmware
>> +updates.
>> +A capsule file may contain various types of firmware blobs which are to be
>> +applied to the system.
>> +If a capsule file is placed in the /EFI/CapusuleUpdate directory of the EFI
>> +system partition, U-Boot will try to execute the update at the next reboot.
>>
>> Optionally, a capsule file can be signed with a given private key.
>> In this case, the update will be authenticated by verifying the signature
>> before applying.
>>
>> -Additionally, an empty capsule file can be generated for acceptance or
>> -rejection of firmware images by a governing component like an Operating
>> -System. The empty capsules do not require an image-blob input file.
>> -
>> +Additionally, an empty capsule file can be generated to indicate the acceptance
>> +or rejection of firmware images by a governing component like an operating
>> +system.
>> +Empty capsules do not require an image-blob input file.
>>
>> .B mkeficapsule
>> takes any type of image files when generating non empty capsules, including:
>> --
>> 2.38.1
>>
>
> BTW as someone else mentioned, this functionality should be in binman too.
>
> Regards,
> Simon
This program is distributed by Debian/Ubuntu in package u-boot-tools.
Please, do not remove it.
Binman is not distributed by Debian.
Best regards
Heinrich
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH 1/1] doc: rework doc/mkeficapsule.1
2023-01-23 18:50 ` Heinrich Schuchardt
@ 2023-01-23 22:25 ` Simon Glass
0 siblings, 0 replies; 4+ messages in thread
From: Simon Glass @ 2023-01-23 22:25 UTC (permalink / raw)
To: Heinrich Schuchardt; +Cc: Ilias Apalodimas, u-boot
Hi Heinrich,
On Mon, 23 Jan 2023 at 11:50, Heinrich Schuchardt
<heinrich.schuchardt@canonical.com> wrote:
>
> On 1/23/23 19:42, Simon Glass wrote:
> > Hi Heinrich,
> >
> > On Mon, 23 Jan 2023 at 04:24, Heinrich Schuchardt
> > <heinrich.schuchardt@canonical.com> wrote:
> >>
> >> * Indicate the location of the directory for EFI capsules.
> >> * Improve the readability.
> >>
> >> Signed-off-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>
> >> ---
> >> doc/mkeficapsule.1 | 21 +++++++++++----------
> >> 1 file changed, 11 insertions(+), 10 deletions(-)
> >>
> >> diff --git a/doc/mkeficapsule.1 b/doc/mkeficapsule.1
> >> index 6fb2dd0810..1ca245a10f 100644
> >> --- a/doc/mkeficapsule.1
> >> +++ b/doc/mkeficapsule.1
> >> @@ -11,22 +11,23 @@ mkeficapsule \- Generate EFI capsule file for U-Boot
> >> .RI [ options ] " " [ image-blob ] " " capsule-file
> >>
> >> .SH "DESCRIPTION"
> >> +The
> >> .B mkeficapsule
> >> -command is used to create an EFI capsule file for use with the U-Boot
> >> -EFI capsule update.
> >> -A capsule file may contain various type of firmware blobs which
> >> -are to be applied to the system and must be placed in the specific
> >> -directory on the UEFI system partition.
> >> -An update will be automatically executed at next reboot.
> >> +command is used to create an EFI capsule file to be used by U-Boot for firmware
> >> +updates.
> >> +A capsule file may contain various types of firmware blobs which are to be
> >> +applied to the system.
> >> +If a capsule file is placed in the /EFI/CapusuleUpdate directory of the EFI
> >> +system partition, U-Boot will try to execute the update at the next reboot.
> >>
> >> Optionally, a capsule file can be signed with a given private key.
> >> In this case, the update will be authenticated by verifying the signature
> >> before applying.
> >>
> >> -Additionally, an empty capsule file can be generated for acceptance or
> >> -rejection of firmware images by a governing component like an Operating
> >> -System. The empty capsules do not require an image-blob input file.
> >> -
> >> +Additionally, an empty capsule file can be generated to indicate the acceptance
> >> +or rejection of firmware images by a governing component like an operating
> >> +system.
> >> +Empty capsules do not require an image-blob input file.
> >>
> >> .B mkeficapsule
> >> takes any type of image files when generating non empty capsules, including:
> >> --
> >> 2.38.1
> >>
> >
> > BTW as someone else mentioned, this functionality should be in binman too.
> >
> > Regards,
> > Simon
>
> This program is distributed by Debian/Ubuntu in package u-boot-tools.
> Please, do not remove it.
What are you wanting not to remove?
>
> Binman is not distributed by Debian.
Would that be helpful?
Regards,
Simon
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2023-01-23 22:26 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-01-23 11:23 [PATCH 1/1] doc: rework doc/mkeficapsule.1 Heinrich Schuchardt
2023-01-23 18:42 ` Simon Glass
2023-01-23 18:50 ` Heinrich Schuchardt
2023-01-23 22:25 ` Simon Glass
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.