Difference between pages "GNOME First Steps" and "Package:Gentoolkit"

(Difference between pages)
 
m
 
Line 1: Line 1:
=== What is GNOME? ===
+
{{Ebuild
 
+
|Summary=Collection of administration scripts for funtoo
"GNOME 3 is an easy and elegant way to use your computer. It is designed to put you in control and bring freedom to everybody. GNOME 3 is developed by the GNOME community, a diverse, international group of contributors that is supported by an independent, non-profit foundation." — [http://gnome.org GNOME]
+
|CatPkg=app-portage/gentoolkit
 
+
=== Prerequisites ===
+
 
+
==== From a Clean Install ====
+
 
+
Ensure that the [[X Window System]] is installed.
+
 
+
=== Preparing to emerge ===
+
 
+
To get your system ready to emerge gnome, first set your system flavor to desktop, and enable the gnome profile mix-in. To accomplish this, do the following:
+
 
+
{{console|recipe=setup,setup-light|desc=Set profile|body=
+
# ##i##eselect profile set-flavor funtoo/1.0/linux-gnu/flavor/desktop
+
# ##i##eselect profile add funtoo/1.0/linux-gnu/mix-ins/gnome
+
 
}}
 
}}
 +
{{PageNeedsUpdates}}
 +
Gentoolkit is a collection of tools used by Gentoo Linux to administer and develop the Portage package management system. The tools are managed and installed by Portage itself; on a Funtoo Linux system one can install gentoolkit by issuing the following command:
 +
<console>###i## emerge gentoolkit</console>
  
By enabling the gnome mix-in, various USE and other settings will be optimized to provide you with a pain-free GNOME installation experience.
+
The tools are split into two related packages: gentoolkit and gentoolkit-dev. As with the rest of Portage they are written in Python.  
  
=== Emerging ===
+
Gentoolkit provides:
 +
* eclean
 +
* enalyze
 +
* equery
 +
* eread
 +
* euse
 +
* glsa-check
 +
* revdep-rebuild
  
You are provided with two packages that will pull in this desktop environment:
+
== equery ==
 +
Equery is a tool that displays  information about the installed packages on the system. equery is based on a system of modules, , running it with out arguments displays a list of options
  
* ''gnome''
+
<console>###i## equery</console>
  
{{fancynote|This is the "whole shabang" - pulls in a range of applications made for the gnome desktop environment including a few games, an archive manager, a system monitor, a web browser, a terminal, etc.}}
+
=== equery b ===
 +
Running equery with the b flag is useful to determine which package a file comes from.
  
* ''gnome-light''
+
<console>###i## equery b /usr/lib/libpam.so
 +
* Searching for /usr/lib/libpam.so ...
 +
sys-libs/pam-1.1.8-r2 (/usr/lib64/libpam.so)
 +
</console>
  
{{fancynote|As the name implies, this pulls in the base minimal you need to get a functioning GNOME Desktop Environment.}}
+
=== equery f ===
 +
Running equery with the f flag is useful to show all installed files from a package.
  
==== GNOME 3.14 from a clean install ====
+
<console>###i## equery f domination
 
+
* Searching for domination ...
===== gnome =====
+
* Contents of games-board/domination-1.1.1.5:
 
+
/usr
To emerge ''gnome'' run the following command
+
/usr/games
 
+
/usr/games/bin
{{console|recipe=setup|desc=Emerging GNOME|body=
+
/usr/games/bin/domination
# ##i## emerge gnome
+
...
}}
+
 
+
===== gnome-light =====
+
 
+
To emerge ''gnome-light'' run the following command
+
 
+
{{console|recipe=setup-light|desc=Emerging a minimal GNOME environment (alternative)|body=
+
# ##i## emerge gnome-light
+
}}
+
 
+
==== Upgrading from GNOME 3.12 ====
+
 
+
To update either ''gnome'' or ''gnome-light'' run the following command:
+
 
+
{{console|body=
+
# ##i## emerge -vauDN world
+
}}
+
=== Subsystems ===
+
 
+
==== Bluetooth ====
+
 
+
For bluetooth support, ensure that:
+
 
+
# Bluetooth support is enabled in your kernel (using modules is fine).
+
# Your bluetooth hardware is turned on.
+
# Add the <code>bluetooth</code> startup script to the default runlevel, and start it.
+
 
+
This can be done as follows:
+
 
+
<console>
+
# ##i##rc-update add bluetooth default
+
# ##i##rc
+
 
</console>
 
</console>
  
Once this is done, you should now be able to navigate to ''Settings'' -> ''Bluetooth'' and turn bluetooth on. The icon next to devices should now animate and you should be able to discover and add devices such as keyboards.
+
== glsa-check ==
 +
Glsa-check shows what potential vulnerabilities your system has.
  
{{Note|1=
+
<console>###i## glsa-check -l
Additional kernel drivers may need to be enabled for certain input devices. For example, for the bluetooth Apple Magic Trackpad, the following option must be enabled in your kernel:
+
[A] means this GLSA was marked as applied (injected),
 +
[U] means the system is not affected and
 +
[N] indicates that the system might be affected.
  
{{kernelop|title=Device Drivers,HID support,HID bus support,Special HID drivers|desc=
+
201310-15 [N] GNU Automake: Multiple vulnerabilities ( sys-devel/automake )
<M> Apple Magic Mouse/Trackpad multi-touch support
+
}}}}
+
 
+
==== Printing ====
+
 
+
To enable printing support, add <code>cupsd</code> to the default runlevel:
+
 
+
<console>
+
# ##i##rc-update add cupsd default
+
# ##i##rc
+
 
</console>
 
</console>
  
You should now be able to navigate to ''Settings'' -> ''Printers'' and add printers to your system, and print.
+
=gentoolkit-dev=
 
+
This package contains Portage development tools.
==== Scanning ====
+
 
+
To enable scanning support, add your user account to the <code>lp</code> group. This will allow your user to access the USB scanner.
+
 
+
Then, <code>emerge xsane</code>, and run it. It should be able to access your scanner.
+
 
+
=== Finishing Touches ===
+
 
+
==== X ====
+
 
+
===== Setting up xdm (GUI log-in) =====
+
 
+
Typically, you will want to use <code>gdm</code>, the GNOME display manager, to log in to GNOME. This will allow you to log in graphically, rather than using the text console.
+
 
+
To enable gdm, edit <code>/etc/conf.d/xdm</code> and set <code>DISPLAYMANAGER</code> to <code>gdm</code> instead of <code>xdm</code>. Then, perform the following steps to add <code>xdm</code> to the default runlevel, and have it start automatically from now on when your system starts:
+
 
+
{{Note|Funtoo's <code>/etc/init.d/xdm</code> initscript has been modified to start the requisite services <code>dbus</code>, <code>openrc-settingsd</code> and <code>consolekit</code> prior to starting <code>gdm</code>.}}
+
 
+
{{console|recipe=setup|desc=Enable the GNOME display manager|body=
+
# ##i## rc-update add xdm default
+
}}
+
 
+
Then, if you want to start it now do:
+
 
+
{{console|body=
+
# ##i##rc
+
}}
+
 
+
But you should reboot to avoid having an open login terminal.
+
 
+
===== Setting up xinitrc (text log-in) =====
+
 
+
Adding the following to your <code>~/.xinitrc</code> file is sufficient:
+
 
+
<pre>
+
# Fix Missing Applications in Gnome
+
export XDG_MENU_PREFIX=gnome-
+
 
+
# Properly Launch the Desired X Session
+
exec ck-launch-session gnome-session
+
</pre>
+
 
+
Additionaly, if you need support for different input sources, there is no longer a need to configure IBus or SCIM in your <code>.xinitrc</code> file as GNOME uses IBus natively. Simply configure it in the Control Center under Region & Language.
+
 
+
=== Automatically Starting Applications at Login ===
+
 
+
When using an old-fashioned <code>.xinitrc</code>, starting up applications when X starts is relatively easy. When using GDM, this can still be accomplished, by using the <code>~/.xprofile</code> file. Here's my sample <code>.xprofile</code> to start <code>xflux</code> to dim the screen at night:
+
 
+
<pre>
+
xflux -z 87107
+
</pre>
+
 
+
{{Note|Remember to add a <code>&</code> at the end of any command that doesn't return to the shell prompt after running.}}
+
 
+
=== games ===
+
Gnome has several games that can be added on to your install.  By default most games are not included in gnome's emerge.
+
 
+
Users wishing to play games need to be added to the games group:
+
{{console|body=###i## gpasswd -a $USER games}}
+
 
+
game list:
+
;gnome-sudoku
+
;gnome-mastermind
+
;gnome-nibbles
+
;gnome-robots
+
;gnome-chess
+
;gnome-hearts
+
;gnome-mahjongg
+
;gnome-mines
+
;gnome-klotski
+
;gnome-tetravex
+
 
+
game system emulators:
+
 
+
;gnomeboyadvance
+
;gnome-mud
+
 
+
=== Significant Known Issues (Workarounds Available) ===
+
 
+
[https://bugs.funtoo.org/browse/FL-1678 FL-1678]: Bluetooth interface gives wrong pairing key
+
 
+
[https://bugs.funtoo.org/browse/FL-1687 FL-1687]: Wallpaper corruption when resuming from suspend
+
  
[[Category:Desktop]]
+
* eviewcvs - Generates ViewCVS URLs.
[[Category:First Steps]]
+
* gensync - Synchronize local Portage tree against an arbitrary upstream repository.
[[Category:Official Documentation]]
+
* ekeyword - Change/update keywords in a set of ebuilds.
 +
* ebump - Bump the revision number of an ebuild and all support files.
 +
* echangelog - Automatically create ebuild changelog entries.
 +
{{EbuildFooter}}

Revision as of 12:33, March 3, 2015

app-portage/gentoolkit


Source Repository:Repository:Progress Overlay


Summary: Collection of administration scripts for funtoo


News

Drobbins

ARM Rebuild

ARM systems will use new stage3's that are not compatible with earlier versions.
2015-06-27 by Drobbins
Drobbins

ABI X86 64 and 32

Funtoo Linux has new 32-bit compatibility libraries inherited from Gentoo. Learn about them here.
2015-06-18 by Drobbins
Drobbins

Pre-built kernels!

Funtoo stage3's are now starting to offer pre-built kernels for ease of install. read more....
2015-05-12 by Drobbins
More...

Gentoolkit

Tip

We welcome improvements to this page. To edit this page, Create a Funtoo account. Then log in and then click here to edit this page. See our editing guidelines to becoming a wiki-editing pro.

Gentoolkit is a collection of tools used by Gentoo Linux to administer and develop the Portage package management system. The tools are managed and installed by Portage itself; on a Funtoo Linux system one can install gentoolkit by issuing the following command:

# emerge gentoolkit

The tools are split into two related packages: gentoolkit and gentoolkit-dev. As with the rest of Portage they are written in Python.

Gentoolkit provides:

  • eclean
  • enalyze
  • equery
  • eread
  • euse
  • glsa-check
  • revdep-rebuild

equery

Equery is a tool that displays information about the installed packages on the system. equery is based on a system of modules, , running it with out arguments displays a list of options

# equery

equery b

Running equery with the b flag is useful to determine which package a file comes from.

# equery b /usr/lib/libpam.so
 * Searching for /usr/lib/libpam.so ... 
sys-libs/pam-1.1.8-r2 (/usr/lib64/libpam.so)

equery f

Running equery with the f flag is useful to show all installed files from a package.

# equery f domination
 * Searching for domination ...
 * Contents of games-board/domination-1.1.1.5:
/usr
/usr/games
/usr/games/bin
/usr/games/bin/domination
...

glsa-check

Glsa-check shows what potential vulnerabilities your system has.

# glsa-check -l
[A] means this GLSA was marked as applied (injected),
[U] means the system is not affected and
[N] indicates that the system might be affected.

201310-15 [N] GNU Automake: Multiple vulnerabilities ( sys-devel/automake )

gentoolkit-dev

This package contains Portage development tools.

  • eviewcvs - Generates ViewCVS URLs.
  • gensync - Synchronize local Portage tree against an arbitrary upstream repository.
  • ekeyword - Change/update keywords in a set of ebuilds.
  • ebump - Bump the revision number of an ebuild and all support files.
  • echangelog - Automatically create ebuild changelog entries.