Difference between pages "Reporting Bugs" and "Install/pt-br/Kernel"

(Difference between pages)
m (update to include emerge --info && build log information per oleg's request.)
 
 
Line 1: Line 1:
The Funtoo community's goal is to provide a seamless and problem-free computing experience, and we take all bugs seriously. Please use the following resources for reporting bugs, technical support, and troubleshooting assistance:
+
<noinclude>
 +
{{InstallPart|Kernel Installation}}
 +
</noinclude>
 +
=== Kernel ===
  
=== Collecting Info ===
+
Starting mid-May 2015, Funtoo Linux stage3's include a pre-built {{c|debian-sources}} kernel to make installation faster and easier. To see if debian-sources is installed, type:
Before submitting bugs collect information about your system, & problem.
+
  
{{console|body=###i## emerge --info > /tmp/emergeinfo.txt}}
+
{{console|body=
 +
(chroot) # ##i##emerge -s debian-sources
 +
Searching...   
 +
[ Results for search key : ##b##debian-sources##!b## ]
 +
[ Applications found : ##b##1##!b## ]
  
Towards the end of failed emerges are messages about build logs.
+
*  ##b##sys-kernel/debian-sources##!b##
 +
      ##g##Latest version available:##!g## 3.19.3
 +
      ##g##Latest version installed:##!g## 3.19.3
 +
      ##g##Size of files:##!g## 81,292 kB
 +
      ##g##Homepage:##!g##      http://www.debian.org
 +
      ##g##Description:##!g##  Debian Sources (and optional binary kernel)
 +
      ##g##License:##!g##      GPL-2
 +
}}
  
{{note|This is an example, your exact messages will vary.  Use your emerge output rather than this example.}}
+
If a version is listed under {{c|Latest version installed}}, then debian-sources is already pre-built for you and you can skip the rest of the Kernel section, and proceed to the [[#Installing a Bootloader|Installing a Bootloader section]].
* The complete build log is located at '/var/tmp/portage/sys-fs/lvm2-2.02.111/temp/build.log'
+
  
==== IRC ====
+
==== Building the Kernel ====
  
The {{c|#funtoo}} IRC channel on freenode available for informal, real-time technical support and troubleshooting. Please use Funtoo channels rather than Gentoo channels for Funtoo Linux support.
+
If you need to build a kernel for Funtoo Linux, please follow these steps:
  
To share information on irc use {{package|app-text/wgetpaste}}, and share links rather than posting directly to the channel.
+
{{Fancynote|1=
 +
See [[Funtoo Linux Kernels]] for a full list of kernels supported in Funtoo Linux. We recommend <code>debian-sources</code> for new users.}}
  
==== Support Forums ====
+
{{fancyimportant|1=
 +
<code>debian-sources</code> with <code>binary</code> USE flag requires at least 14GB free in <code>/var/tmp</code> and takes around 1 hour to build on a Intel Core i7 Processor.}}
  
The following Web-based discussion resources are specifically created for community-based support and troubleshooting, and are monitored by the Funtoo Linux core team.  Under the new thread text area, attach the emerge info, and build logs directly to your posts rather than using wgetpaste links.  Wgetpaste links expire where the forums attached files are timeless.
+
Let's emerge our kernel:
  
* [http://forums.funtoo.org/forum/7-installation-help/ Installation Help]
+
<console>
* [http://forums.funtoo.org/forum/9-portage-help/ Portage Help]
+
(chroot) # ##i##emerge debian-sources
* [http://forums.funtoo.org/forum/4-desktop-help/ Desktop Help]
+
</console>
* [http://forums.funtoo.org/forum/8-server-help/ Server Help]
+
  
=== Bug tracker ===
+
Once <code>emerge</code> completes, you'll have a brand new kernel and initramfs installed to <code>/boot</code>, plus kernel headers installed in <code>/usr/src/linux</code>, and you'll be ready to configure the boot loader to load these to boot your Funtoo Linux system.
  
We are using JIRA for tracking Funtoo Linux issues. See [http://bugs.funtoo.org bugs.funtoo.org] to access the bug tracker.
+
{{fancynote|NVIDIA card users: the <code>binary</code> USE flag installs the Nouveau drivers which cannot be loaded at the same time as the proprietary drivers, and cannot be unloaded at runtime because of KMS. You need to blacklist it under <code>/etc/modprobe.d/</code>.}}
  
For information on how to properly use the bug tracker, see below.
+
{{fancynote|For an overview of other kernel options for Funtoo Linux, see [[Funtoo Linux Kernels]]. There may be modules that the Debian kernel doesn't include, a situation where [http://www.funtoo.org/wiki/Funtoo_Linux_Kernels#Using_Debian-Sources_with_Genkernel genkernel] would be useful. Also be sure to see [[:Category:Hardware Compatibility|hardware compatibility]] information.}}
 
+
==== How To Report Bugs ====
+
 
+
# First, {{CreateAccount}}.
+
# Go to Issues -> Create Issue
+
# Set Issue Type to "Bug".
+
# For Summary, enter a clear description of the defect.
+
# For Description, enter:
+
## a clear, detailed description of the problem
+
## clear steps to reproduce the problem
+
## output of the failure
+
## a description of what you expected to happen instead of the failure
+
## attach emerge info, and build logs under bug description
+
 
+
When your issue is created, it will have a short name such as FL-17 that can be used to reference it.
+
 
+
Each issue is intended to track a specific defect in Funtoo Linux. Please respect the focus of each individual issue. Use the mailing lists and forums for general discussion.
+
 
+
==== Bug Status ====
+
 
+
When bugs are first reported, they are marked as ''Awaiting Review''. This means that they are waiting to be reviewed by staff. Once reviewed and possibly revised somewhat, they will be moved into ''Queued'' status. This means that the bug has been accepted and is in queue to being fixed. When a developer starts working on the bug, it will move to ''In Progress'' status. This means that the bug is being actively worked on. When the bug is resolved, it will move to ''Test/Integration'' status, which means that it will now be tested and fully integrated into Funtoo Linux. When it has been fully integrated into Funtoo Linux, it will be marked as ''Closed'', and the resolution will be set appropriately.
+
 
+
There are a few other statuses that are used. ''Upstream Review'' is used when a bug is submitted to an upstream project and is awaiting review or feedback. '''Workaround''' is used when a short-term fix is used to resolve a problem, but a longer-term fix is also required. There is also a ''Community Discussion'' status. This status is used when we are actively requesting community feedback. In general, we want to use JIRA as a way to have a very focused discussion about a specific bug, so we don't want the bug comments to be used like forums posts as a type of general discussion. Use the forums for this.
+
 
+
==== Fixing Bugs ====
+
 
+
When developers fix bugs, they can reference the issue(s) being fixed in the git commit message, by saying something like "This fixes FL-22". The funtoo-overlay and other repositories are integrated with JIRA, so you will be able to see links to these commits by going to the ''Commits'' tab for the issue.
+
 
+
==== Upstream Bug Reporting ====
+
 
+
Please report all bugs to us first, so we are aware of the issue. We will handle reporting bugs to upstream projects, including Gentoo Linux.
+

Revision as of 19:06, May 28, 2015


Note

This is a template that is used as part of the Installation instructions which covers: Kernel Installation. Templates are being used to allow multiple variant install guides that use most of the same re-usable parts.


Kernel

Starting mid-May 2015, Funtoo Linux stage3's include a pre-built debian-sources kernel to make installation faster and easier. To see if debian-sources is installed, type:

(chroot) # emerge -s debian-sources
Searching...    
[ Results for search key : debian-sources ]
[ Applications found : 1 ]

*  sys-kernel/debian-sources
      Latest version available: 3.19.3
      Latest version installed: 3.19.3
      Size of files: 81,292 kB
      Homepage:      http://www.debian.org
      Description:   Debian Sources (and optional binary kernel)
      License:       GPL-2


If a version is listed under Latest version installed, then debian-sources is already pre-built for you and you can skip the rest of the Kernel section, and proceed to the Installing a Bootloader section.

Building the Kernel

If you need to build a kernel for Funtoo Linux, please follow these steps:

Note

See Funtoo Linux Kernels for a full list of kernels supported in Funtoo Linux. We recommend debian-sources for new users.

Important

debian-sources with binary USE flag requires at least 14GB free in /var/tmp and takes around 1 hour to build on a Intel Core i7 Processor.

Let's emerge our kernel:

(chroot) # emerge debian-sources

Once emerge completes, you'll have a brand new kernel and initramfs installed to /boot, plus kernel headers installed in /usr/src/linux, and you'll be ready to configure the boot loader to load these to boot your Funtoo Linux system.

Note

NVIDIA card users: the binary USE flag installs the Nouveau drivers which cannot be loaded at the same time as the proprietary drivers, and cannot be unloaded at runtime because of KMS. You need to blacklist it under /etc/modprobe.d/.

Note

For an overview of other kernel options for Funtoo Linux, see Funtoo Linux Kernels. There may be modules that the Debian kernel doesn't include, a situation where genkernel would be useful. Also be sure to see hardware compatibility information.