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.