Manually editing a existing apkovl: Difference between revisions
No edit summary |
m (file ownership notes in case of non-root tar extraction) |
||
Line 4: | Line 4: | ||
== Unpack the apkovl == | == Unpack the apkovl == | ||
Unpack the apkovl into a temp dir | Unpack the apkovl into a temp dir (''preferably run tar as root to preserve target's UIDs & GIDs''): | ||
{{Cmd|mkdir /tmp/testbox | {{Cmd|mkdir /tmp/testbox | ||
tar -xvzf testbox.apkovl.tar.gz -C /tmp/testbox/}} | tar -xvzf testbox.apkovl.tar.gz -C /tmp/testbox/}} | ||
Line 14: | Line 14: | ||
* Remove files/folders | * Remove files/folders | ||
* etc. | * etc. | ||
== Ensure proper ownership == | |||
By default, tar will preserve file permissions and ownership when creating an archive. However, on extraction, if you did not extract the archive as root, file ownership may have been substituted with the current user (since changing file ownership usually requires superuser privileges). If you didn't extract the apkovl as root, take a moment to correct ownership (by target's UIDs & GIDs rather than local user & group names)—especially for important directories like ''/etc'' and ''/root''. | |||
== Pack the apkovl == | == Pack the apkovl == |
Revision as of 21:14, 10 February 2023
You might end up in a situation when you find it necessary to edit an apkovl (without having to boot a box using the apkovl itself).
Unpack the apkovl
Unpack the apkovl into a temp dir (preferably run tar as root to preserve target's UIDs & GIDs):
mkdir /tmp/testbox tar -xvzf testbox.apkovl.tar.gz -C /tmp/testbox/
Make your modifications
Do your modifications in '/tmp/testbox/'
- Edit files/folders
- Add files/folders
- Remove files/folders
- etc.
Ensure proper ownership
By default, tar will preserve file permissions and ownership when creating an archive. However, on extraction, if you did not extract the archive as root, file ownership may have been substituted with the current user (since changing file ownership usually requires superuser privileges). If you didn't extract the apkovl as root, take a moment to correct ownership (by target's UIDs & GIDs rather than local user & group names)—especially for important directories like /etc and /root.
Pack the apkovl
When your modifications are done, you should pack your apkovl
cd /tmp/testbox tar -czf /tmp/testbox.apkovl.tar.gz *
Replace the original apkovl
You now have a new/modified apkovl.
Replace your original apkovl (on your media) with '/tmp/testbox.apkovl.tar.gz' and boot.