Show Menu
Cheatography

Genbox Cheat Sheet by

Setup

Action
Genbox-0.9
Genbox-1.x
Install
sh ./inst­all.sh

sudo /opt/g­enb­ox/­bin­/ge­nbox-ng --image --download

sudo /opt/g­enb­ox/­bin­/ge­nbox-ng --image --set-­default gbx-0.9
sudo ./genb­ox-­ins­taller /opt/g­enbox
Enter
sudo /opt/g­enb­ox/­bin­/ge­nbox-ng
sudo /opt/g­enb­ox/­sbi­n/g­enbox
Enter as user
Not applicable
sudo /opt/g­enb­ox/­sbi­n/g­enbox -u
Uninstall
sudo rm -fr /opt/g­enbox/
sudo /opt/g­enb­ox/­sbi­n/g­enb­ox-wipe

Package management

Action
Genbox-0.9 and Genbox-1.x
Update packages reposi­tories
emerge --sync
Update installed packages
emerge -uDavn world
Install package
<pk­g>
emerge <pk­g>
Install package
<pk­g>
at version
N
emerge =<p­kg>-N
Uninstall package
<pk­g>
emerge -C <pk­g>
List all installed packages
list
List all files installed by package
<pk­g>
equery files <pk­g>
List with which USE flags package
<pk­g>
is installed
equery uses <pk­g>
Find to which package belongs
<fi­le>
file.
equery belongs <fi­le>
Find which package(s) depends on package <pk­g>
equery depends <pk­g>
Handle config­uration file updates
etc-update
Find packages matching
<pa­tte­rn>
emerge -s <pa­tte­rn>
Display path to the ebuild used to install package
<pk­g>
equery which <pk­g>
The previous commands are valid for host packages. For target packages, use:
- xmerge instead of emerge
- xlist instead of list
- xquery (Genbo­x-1.x) or xexec equery (Genbo­x-0.9) instead of equery
- xtc-update instead of etc-update

Overlay management

Action
Genbox-0.9
Genbox-1.x
List available host* overlays
Not applicable
layman -L
List installed host* overlays
eov --list
layman -l
Update all host* overlays
Not applicable
layman -S
Update host* overlay
<ov>
eov --sync <ov>
layman -s <ov>
Add overlay <ov>
eov --add <ov> --uri=­<ur­i> --prot­o=<­pro­to> --bran­ch=­<br­anc­h>
layman -a <ov>
Remove overlay <ov>
eov --rm <ov>
layman -d <ov>
Display inform­ation about overlay <ov>
Not applicable
layman -i <ov>
* To do the same actions for the target, use xov instead of eov for Genbox-0.9 and xlayman instead of layman for Genbox­-1.x.

Target management

Action
Genbox-0.9 and Genbox-1.x
List available targets matching
<pa­tte­rn>
xtarget -pv <pa­tte­rn>
List installed targets
xtarget -lv
Set
<fo­o>
as current target
xtarget -s <fo­o>
Sync target descri­ption overlay
xtarget --sync
Install target
<tg­t>
for arch
<ar­ch>
xtarget -c -a <ar­ch> <tg­t>
Install target
<tg­t>
at version
1.2.3
for arch
<ar­ch>
xtarget -c -a <ar­ch> =<t­gt>­-1.2.3
Update target reposi­tories
xmerge --sync
*
Update target packages
xmerge -uDavn world
Install package
<pk­g>
at version
N
xmerge =<p­kg>-N
Install masked** package
<pk­g>
FEATUR­ES=­"­nop­ack­age­s" xmerge <pk­g>

xmerge --igno­re-­pro­fil­e-v­ersion <pk­g>
(Genbo­x2016 only)
xmerge -I <pk­g>
(Genbo­x2016 only)
* Currently, Genbox-1.x is unable to correctly sync a mercurial reposi­tory.
** Only valid for packages masked by version. It won't work with packages masked by 'corru­ption', 'missing keyword', 'license', 'eapi'...

Working with target

Action
Genbox-0.9
Genbox-1.x
Setup a shell with target enviro­nment
xshell
xshell
Test target ebuild
<eb>
instal­lation
xbuild <eb> clean fetch unpack compile install
xbuild <eb> clean install
Add package
<pk­g>
at version
<ve­r>
to target profile
echo "­*<p­kg>­" >> packages 
echo "­=<p­kg>­-<v­er>­" >> packages
echo "­*<p­kg>­" >> packages 
echo "­><p­kg>­-<v­er>­" >> packag­e.mask
Update package <pk­g> at version
<ve­r+1>
in target profile
Edit
packages
file
Edit
packag­e.mask
file
Bump package
<pk­g>
locally cloned in
<sr­c>
directory
bosse -i <sr­c>
Not ported yet
Bump target
<tg­t>
based on template ebuild
<eb>
xbump -u <eb> --tag
Not ported yet
Create a prebuilt for target
<tg­t>
with archit­ecture
<ar­ch>
xbuilder -a <ar­ch> =<t­gt>
xbuilder -a <ar­ch> =<t­gt>

Important files changes

Utility
Genbox-0.9
Genbox-1.x
Custom settings for Portage
/etc/m­ake.conf
/etc/p­ort­age­/ma­ke.conf
Symlink to profile
/etc/m­ake.pr­ofile
/etc/p­ort­age­/ma­ke.p­rofile
Host overlay base directory
/usr/l­oca­l/p­ortage
/var/l­ib/­layman/
(confi­gur­able)
Overlay manager config­uration files
/etc/x­ov.conf
/etc/l­aym­an/­lay­man.cfg
xbuild
destin­ation directory
${ROOT­}/w­ork­/${­CAT­EGO­RY}­/${PF}
${ROOT­}/x­bui­ld/­por­tag­e/$­{CA­TEG­ORY­}/${PF}
 

Comments

No comments yet. Add yours below!

Add a Comment

Your Comment

Please enter your name.

    Please enter your email address

      Please enter your Comment.