Manuel:Page Principale

Quick links: Alpha AMD64
(x86_64) HPPA
(PA-RISC) MIPS PPC PPC64 SPARC x86

Le manuel Gentoo est le produit d'un travail ayant pour but de centraliser la documentation en un manuel cohérent. Ce manuel contient les instructions d'installation pour une installation utilisant Internet, et des sections additionnelles sur l'utilisation des outils logiciels natifs de Gentoo tels que le système d'initialisation OpenRC et le gestionnaire de paquets Portage.

La manuel de Gentoo

Les architectures

Gentoo Linux est disponible pour de nombreuses architectures informatiques.

Une architecture de jeu d'instructions (wikipedia), ou architecture pour faire plus court, est une famille de CPUs (processeurs) qui supportent les même instructions. Les deux architectures dominantes dans le monde des ordinateurs personnels sont x86 et X86_64 (pour laquelle Gentoo utilise la même notation, amd64). Néanmoins, il en existe beaucoup d'autres, tel que : sparc, ppc (famille des PowerPC), mips, arm, etc.

Une distribution polyvalente comme Gentoo supporte de nombreuses architectures. Ci-dessous, vous trouverez un rapide résumé des architectures supportées par Gentoo et leurs abréviations. La plupart des personnes ne connaissant pas l'architecture de leur système sont probablement concernées par amd64.

Consulter le manuel

La liste ci-dessous présente une vue d'ensemble des différentes architectures supportées par les divers projets de Gentoo Linux. Il est indispensable de choisir l'architecture adéquate avant de commencer la consultation du manuel d'installation. Vérifier l'architecture du processeur avant de continuer.

The main link for each Handbook provides a section-by-section view for each of the four chapters. The Handbook project recommends this section-by-section view when installing Gentoo.

Alternatively, a single page per-chapter view is provided for readers who wish to view a single chapter at a time. This view is useful for easily searching a chapter or for printing.

Remarque
Les architectures arm et arm64 sont supportées par le projet Gentoo mais n'ont pas encore de manuels disponibles à cause de trop nombreuses variations dans les systèmes sur puce (system-on-chip). Cela est difficilement réalisable pour les mainteneurs du projet (des Manuels) d'entretenir un ensemble cohérent d'instructions d'installation. Se référer à la page du projet ARM ou celle du projet ARM64 et enfin bug #534376 pour plus d'informations.

De la même manière, l'architecture riscv est supportée, cependant elle n'a pas de Manuel dédié (pour l'instant). Plus d'informations peuvent être trouvées sur la page du projet RISC-V.

Une règle d'or pour les nouveaux utilisateurs de Gentoo : si le processeur a été fabriqué après 2015 et que le fabricant est Intel ou AMD, choisir le manuel AMD64 est probablement la bonne décision.

Manuel Alpha

L'architecture Alpha est une architecture 64 bits développée par Digital Equipment Corporation (DEC). Elle est encore utilisée par certains serveurs moyen et haut de gamme, mais cette architecture est lentement sur le déclin. Les variantes inclus : ES40, AlphaPC, UP1000 et Noname.

• Parties : Installation – Utiliser Gentoo – Portage – Réseau

Manuel AMD64

AMD64 est une architecture 64 bits qui est compatible avec l'architecture x86 (et ainsi également appelée x86_64). Elle fut utilisée en premier par AMD (sous le nom AMD64) et Intel (sous le nom EM64T), elle est aujourd'hui l'architecture la plus employée pour les ordinateurs personnels. On la retrouve aussi couramment dans les serveurs. Les variantes inclus : AMD Athlon 64, Opteron, Sempron, Phenom, FX, Ryzen, Threadripper et Epyc, ainsi que Intel Pentium 4, Core2, Core i3, i5, i7, i9, Xeon et certains Atom.

• Parties : Installation – Utiliser Gentoo – Portage – Réseau

Manuel ARM

ARM est une architecture 32 bits qui est très populaire dans les systèmes embarqués et de petits formats. Les sous-architectures ARMv1 à ARMv6 (legacy), à ARMv7 (Cortex), aussi bien que ARMv8-R et ARMv8-M, dans les smartphones, les tablettes tactiles, les consoles portables, les systèmes de navigation par GPS, etc. Les variantes inclus : StrongARM et Cortex-M.

• Il n'existe aucun manuel ARM pour l'instant. Se référer à la page du projet ARM et au manuel des systèmes embarqués maintenu par la communauté pour plus d'informations concernant le support de ARM par Gentoo.

Manuel ARM64

ARM64 est une variante 64 bits de l'architecture ARM pour les systèmes embarqués et les serveurs. La sous-architecture principale, AArch64 (alias ARMv8-A), est produite par quelques fabricants. Les processeurs AArch64 sont intégrés dans les cartes de développement, les smartphones, les tablettes tactiles, les téléviseurs modernes, etc. Les variantes inclus : ARM Cortex-A53, A57, A72, A73, et Qualcomm Kryo, Falkor.

• Il n'existe aucun manuel ARM64 pour l'instant. Référez-vous à la page du projet ARM64 et au manuel des systèmes embarqués maintenu par la communauté pour plus d'informations concernant le support de ARM par Gentoo.

Manuel HPPA

Appelée HPPA, l'architecture PA-RISC est un jeu d'instructions développé par Hewlett-Packard et a été utilisée dans leurs gammes de serveurs moyen et haut de gamme jusqu'en 2008 (après quoi HP utilisera ensuite les processeurs Intel Itanium). Les variantes inclus : HP 9000 et PA-8600.

• Parties : Installation – Utiliser Gentoo – Portage – Réseau

Manuel IA64

IA64 est une architecture 64 bits conçue par Intel et utilisée dans leur gamme de processeurs Intel Itanium. Cette architecture n'est pas compatible avec x86 et x86_64 (alias d'amd64). On la trouve principalement dans les serveurs moyen et haut de gamme.

• Parties : Installation – Utiliser Gentoo – Portage – Réseau

Manuel MIPS

Développée par MIPS Technologies, l'architecture MIPS comprend de multiples sous-familles (nommées révisions) telles que MIPS I, MIPS III, MIPS32 et MIPS64. On la retrouve le plus souvent dans les systèmes embarqués. Les variantes inclus : MIPS32 1074K, et R16000.

• Parties : Installation – Utiliser Gentoo – Portage – Réseau

Manuel PPC

PPC est une architecture 32 bits utilisée par Apple, IBM, et Motorola dans leur processeurs. On les retrouve le plus souvent dans les systèmes embarqués. Les variantes inclus : Apple OldWorld, Apple NewWorld, generi Pegasos, Efika, dans les IBM iSeries plus anciens et pSeries.

• Parties : Installation – Utiliser Gentoo – Portage – Réseau

Manuel PPC64

PPC64 est la variante 64 bits de l'architecture PPC, populaire aussi bien dans les systèmes embarqués que dans les serveurs haut de gamme. Les variantes inclus : IBM RS/6000s, IBM pSeries et IBM iSeries. Les lecteurs de ce manuel peuvent aussi jeter un œil à la page foire-aux-questions pour PPC avant de commencer.

• Parties : Installation – Utiliser Gentoo – Portage – Réseau

Manuel RISC-V

RISC-V est une future architecture 32 bits, 64 bits, et 128 bits avec un jeu d'instructions ouvert. Actuellement, Gentoo supporte la variante 64 bits.

• Il n'existe aucun manuel RISC-V pour l'instant. Se référer à la page du projet RISC-V pour plus d'informations concernant le support de RISC-V par Gentoo.

Manuel SPARC

L'architecture SPARC est mieux connue principalement grâce à ses fabricants, Sun Microsystems (désormais Oracle) et Fujitsu. Elle est employée dans les serveurs ainsi que dans quelques stations de travail. Dans Gentoo, seul les processeurs compatibles avec SPARC64 sont supportées. Les variantes inclus : E3000, Blade 1000 et Ultra 2.

• Parties : Installation – Utiliser Gentoo – Portage – Réseau

Manuel X86

X86 est une architecture 32 bits utilisée par les processeurs parfois qualifiés de « compatibles Intel ». Encore récemment c'était l'architecture la plus courante pour les ordinateurs de bureau. Gentoo supporte les processeurs i486 (toutes les familles) et i686 (support pour Pentium et plus récent ou compatible). Les variantes inclus : i486, i686, AMD Athlon, Intel Core et certains Intel Atom.

• Parties : Installation – Utiliser Gentoo – Portage – Réseau

Foire aux questions

Le manuel peut-il être généré dynamiquement pour chaque choix d'installation ?

Les responsables du manuel Gentoo ont choisi de l'écrire par architecture en utilisant le système d'initialisation par défaut de Gentoo (OpenRC) et un schéma de partitionnement basique. L'objectif du manuel est d'obtenir un système Gentoo fonctionnel, non pas de couvrir toutes les possibilités d'installations (schéma de partions peu communs, systèmes d'initialisations divers et variés, configuration du noyau, utilitaires de gestions du système, etc).

Des concepts tels que le partitionnement avancé, la configuration d'un noyau non générique et les systèmes d'initialisation alternatifs sont expliqués dans d'autres articles du wiki et modifiables publiquement (à titre informatif : n'importe qui avec un compte sur le wiki peut les éditer !).

Nous demandons aux lecteurs de chercher sur le wiki et de découvrir ce qui est déjà disponible avant de demander l'ajout d'une nouvelle section ou d'une édition au manuel. Si vous pensez qu’une nouvelle section générique est nécessaire, alors il faut le proposer en soumettant une requête en suivant les instructions ci-dessous.

Je ne parviens pas à trouver des informations à propos de stage1 dans le manuel. Où dois-je regarder ?

Les instructions sur l'usage d'une archive tar stage1 ou stage2 sont désormais disponibles dans la foire aux questions de Gentoo. La seule méthode d'installation supportée est celle avec stage3.

Comment puis-je améliorer le manuel ?

Les suggestions, commentaires ou idées sur comment rendre meilleurs le manuel sont rapportés dans le projet du manuel via la Page de discussion de l'article en question. La documentation est faites pour la communauté, donc tout retour est véritablement appréciable.

Remarque
Les mainteneurs et éditeurs du manuel sont de l'ordre de deux ou trois membres, merci d'être patient lorsque nous répondons aux nouveaux sujets {{Talk}}. Voir les instructions ci-dessous sur comment suggérer des améliorations au manuel.

Attention, la plupart des décisions qui sont prises durant le développement de la documentation sont basées sur un consensus. Il est impossible d'écrire ou structurer une documentation d'une façon qui puisse combler tout les lecteurs.

Celles et ceux qui ouvre une discussion dans le but d'améliorer le manuel doivent accepter qu'une réponse puisse être « Non ». Typiquement cette réponse est utilisé lorsque nous croyons que l'implémentation actuelle est bénéfique pour la majorité des lecteurs.

Pour pouvoir suivre correctement les problèmes remontées nous vous demandons d'utiliser le modèle {{Talk}} pour chaque discussion que vous ouvrirez. Un exemple de ce qui peut être fait est visible ci-dessous et est suffisant :

CODE Exemple de discussion ouverte

{{Talk|open|date=28 Mars 2017}}
 
Bonjour à l'équipe en charge du manuel,

Je pense qu'il serait plus constructif que la partie "X" du manuel soit améliorée en suivant la méthode "Y". Voici un exemple du code/texte qui pourrait l'améliorer :

(insertion du code ou texte qui pourrait améliorer le contenu ici.)

Merci de considérer ma suggestion. --~~~~

La syntaxe --~~~~ à la fin de l'exemple insère une signature datée lorsque la page est sauvegardée ou pré-visualiser. Cette syntaxe peut être tapée manuellement ou générée en utilisant le bouton Signature avec horodatage dans le bar d'outil d'édition. Les contributeurs du wiki appellent cela « signer une discussion ». Veiller à se rappeler de signer chaque commentaire sur les pages de discussions.

Changelog (NdT: journaux des modifications)

Un travail pour avoir un journal (changelog) sémantique et versionnée pour le manuel et ses contributions peut être lu sur cette page.