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:Progress Overlay

Summary: Collection of administration scripts for funtoo


News

Drobbins

How We're Keeping You At the Center of the Funtoo Universe

Read about recent developments that keep you, our users, at the forefront of our focus as Funtoo moves forward.
10 April 2015 by Drobbins
Mgorny

New OpenGL management in Funtoo

Funtoo is switching to an improved system for managing multiple OpenGL providers (Mesa/Xorg, AMD and NVIDIA). The update may involve blockers and file collisions.
30 March 2015 by Mgorny
Drobbins

Subarch Profiles are coming...

Subarch profiles are on their way! Learn more here.
29 March 2015 by Drobbins
View More News...

Gentoolkit

Tip

This is a wiki page. To edit it, 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.