[v9,14/14] doc/user_manual.md: Document details about deb-src caching

Message ID 20201126112227.3395-1-Vijaikumar_Kanagarajan@mentor.com
State Superseded, archived
Headers show
Series Debsrc caching | expand

Commit Message

Vijai Kumar K Nov. 26, 2020, 1:22 a.m. UTC
Add details about deb-src caching.

Signed-off-by: Vijai Kumar K <Vijaikumar_Kanagarajan@mentor.com>
---
 doc/user_manual.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

Comments

Anton Mikanovich Nov. 26, 2020, 7:28 a.m. UTC | #1
test

26.11.2020 14:22, Vijai Kumar K wrote:
> +Use rootfs postprocessing to parse through the the list fo deb files in ${DEDDIR} and
> +download the corresponding Debian source file using "apt-get source" command.
There are typos, probably should be 'through the list of deb'.
vijai kumar Nov. 26, 2020, 7:56 a.m. UTC | #2
On Thursday, November 26, 2020 at 10:58:54 PM UTC+5:30 ami...@ilbers.de 
wrote:

> test 
>
> 26.11.2020 14:22, Vijai Kumar K wrote: 
> > +Use rootfs postprocessing to parse through the the list fo deb files in 
> ${DEDDIR} and 
> > +download the corresponding Debian source file using "apt-get source" 
> command. 
> There are typos, probably should be 'through the list of deb'. 
>

Yes. Is it possible for you to amend it while applying this series?

Thanks,
Vijai Kumar K
 

>
> -- 
> Anton Mikanovich 
> Promwad Ltd. 
> External service provider of ilbers GmbH 
> Maria-Merian-Str. 8 
> 85521 Ottobrunn, Germany 
> +49 (89) 122 67 24-0 
> Commercial register Munich, HRB 214197 
> General Manager: Baurzhan Ismagulov 
>
>
vijai kumar Nov. 26, 2020, 8:12 a.m. UTC | #3
On Thursday, November 26, 2020 at 11:26:20 PM UTC+5:30 
vijaikumar....@gmail.com wrote:

> On Thursday, November 26, 2020 at 10:58:54 PM UTC+5:30 ami...@ilbers.de 
> wrote:
>
>> test 
>>
>> 26.11.2020 14:22, Vijai Kumar K wrote: 
>> > +Use rootfs postprocessing to parse through the the list fo deb files 
>> in ${DEDDIR} and 
>> > +download the corresponding Debian source file using "apt-get source" 
>> command. 
>> There are typos, probably should be 'through the list of deb'. 
>>
>
> Yes. Is it possible for you to amend it while applying this series?
>

Nevermind. I am resending this patch. its also DEBDIR not DEDDIR.

Thanks,
Vijai Kumar K
 

>
> Thanks,
> Vijai Kumar K
>  
>
>>
>> -- 
>> Anton Mikanovich 
>> Promwad Ltd. 
>> External service provider of ilbers GmbH 
>> Maria-Merian-Str. 8 
>> 85521 Ottobrunn, Germany 
>> +49 (89) 122 67 24-0 
>> Commercial register Munich, HRB 214197 
>> General Manager: Baurzhan Ismagulov 
>>
>>

Patch

diff --git a/doc/user_manual.md b/doc/user_manual.md
index dd6fc34..8827b29 100644
--- a/doc/user_manual.md
+++ b/doc/user_manual.md
@@ -919,3 +919,33 @@  And build the corresponding image target:
 ```
 bitbake mc:qemuarm64-buster:isar-image-base
 ```
+## Cache all upstream Debian source packages in local apt
+
+### Motivation
+
+OSS license compliance: Some licenses require to provide the corresponding sources code,
+other require copyright attributions that may be best provided via the source code. In
+addition, you may want to archive the code locally in order to ensure reproducibility (and
+modifiability) in the future.
+
+Currently the local-apt generated has only Debian binary packages. Extend the local-apt
+to have Debian source packages as well.
+
+### Solution
+
+ - Trigger download of Debian source packages as part of rootfs postprocess.
+
+With the current base-apt implementation, we already cache all the binary packages that
+we download and install onto the target rootfs and buildchroot. This is then used to
+generate a local-apt for offline build.
+
+Use rootfs postprocessing to parse through the the list fo deb files in ${DEDDIR} and
+download the corresponding Debian source file using "apt-get source" command.
+This caches the sources of all the Debian packages that are downloaded and installed onto
+the target rootfs and buildchroots.
+
+By default, the Debian source caching is not enabled.
+To enable it, add the below line to your local.conf file.
+```
+BASE_REPO_FEATURES = "cache-deb-src"
+```