User Guide

Red Hat Developer Toolset User Guide

books        Desktop   documentation  drafts  mss    photos   stuff  svn
books_tests  Desktop1  downloads      images  notes  scripts  svgs
static int kvm_vm_ioctl_deassign_device(struct kvm *kvm,
                 struct kvm_assigned_pci_dev *assigned_dev)
{
         int r = 0;
         struct kvm_assigned_dev_kernel *match;

         mutex_lock(&kvm->lock);

         match = kvm_find_assigned_dev(&kvm->arch.assigned_dev_head,
                                       assigned_dev->assigned_dev_id);
         if (!match) {
                 printk(KERN_INFO "%s: device hasn't been assigned before, "
                   "so cannot be deassigned\n", __func__);
                 r = -EINVAL;
                 goto out;
         }

         kvm_deassign_device(kvm, match);

         kvm_free_assigned_device(kvm, match);

out:
         mutex_unlock(&kvm->lock);
         return r;
}
rhn-channel --available-channels
rhn-channel --add --channel=channel_name
rhn-channel --list
subscription-manager list --available
subscription-manager subscribe --pool=pool_id
subscription-manager list --consumed
yum repolist all
rhel-variant-dts-version-rpms
rhel-variant-dts-version-debug-rpms
rhel-variant-dts-version-source-rpms
yum-config-manager --enable repository
enabled = 1
yum install devtoolset-1.1
yum install package_name
yum install libitm devtoolset-1.1-gdb-gdbserver
debuginfo-install package_name
yum remove devtoolset-1.0-gcc-debuginfo
yum update
debuginfo-install package_name
yum remove devtoolset-1.1\*
yum remove scl-utils\*
scl enable devtoolset-1.1 'gcc -o output_file source_file...'
scl enable devtoolset-1.1 'gcc -o object_file -c source_file'
scl enable devtoolset-1.1 'gcc -o output_file object_file...'
scl enable devtoolset-1.1 'bash'
which gcc
gcc -v
#include <stdio.h>

int main(int argc, char *argv[]) {
  printf("Hello, World!\n");
  return 0;
}
~]$ scl enable devtoolset-1.1 'gcc -o hello hello.c'
./file_name
~]$ ./hello
Hello, World!
scl enable devtoolset-1.1 'g++ -o output_file source_file...'
scl enable devtoolset-1.1 'g++ -o object_file -c source_file'
scl enable devtoolset-1.1 'g++ -o output_file object_file...'
scl enable devtoolset-1.1 'bash'
which g++
g++ -v
#include <iostream>

using namespace std;

int main(int argc, char *argv[]) {
  cout << "Hello, World!" << endl;
  return 0;
}
~]$ scl enable devtoolset-1.1 'g++ -o hello hello.cpp'
./file_name
~]$ ./hello
Hello, World!
scl enable devtoolset-1.1 'gfortran -o output_file source_file...'
scl enable devtoolset-1.1 'gfortran -o object_file -c source_file'
scl enable devtoolset-1.1 'gfortran -o output_file object_file...'
scl enable devtoolset-1.1 'bash'
which gfortran
gfortran -v
      program hello
        print *, "Hello, World!"
      end program hello
~]$ scl enable devtoolset-1.1 'gfortran -o hello hello.f'
./file_name
~]$ ./hello
 Hello, World!
scl enable devtoolset-1.1 'man gcc'
scl enable devtoolset-1.1 'man gfortran'
yum install devtoolset-1.1-libstdc++-docs
scl enable devtoolset-1.1 'gcc -g -o output_file input_file...'
scl enable devtoolset-1.1 'g++ -g -o output_file input_file...'
#include <stdio.h>
#include <limits.h>

int main (int argc, char *argv[]) {
unsigned long int a = 0;
unsigned long int b = 1;
unsigned long int sum;

while (b < LONG_MAX) {
  printf("%ld ", b);
  sum = a + b;
  a = b;
  b = sum;
}

return 0;
}
~]$ scl enable devtoolset-1.1 'gcc -g -o fibonacci fibonacci.c'
debuginfo-install package_name
~]# debuginfo-install glibc
Loaded plugins: product-id, refresh-packagekit, subscription-manager
--> Running transaction check
---> Package glibc-debuginfo.x86_64 0:2.12-1.47.el6_2.5 will be installed
...
scl enable devtoolset-1.1 'gdb file_name'
quit
scl enable devtoolset-1.1 'bash'
which gdb
gdb -v
~]$ scl enable devtoolset-1.1 'gdb fibonacci'
GNU gdb (GDB) Red Hat Enterprise Linux (7.4.50.20120120-43.el6)
Copyright (C) 2012 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.  Type "show copying"
and "show warranty" for details.
This GDB was configured as "x86_64-redhat-linux-gnu".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
(gdb)
list
list [file_name:]line_number
list [file_name:]function_name
set listsize number
(gdb) set listsize 20
(gdb) list
1       #include <stdio.h>
2       #include <limits.h>
3
4       int main (int argc, char *argv[]) {
5         unsigned long int a = 0;
6         unsigned long int b = 1;
7         unsigned long int sum;
8
9         while (b < LONG_MAX) {
10          printf("%ld ", b);
11          sum = a + b;
12          a = b;
13          b = sum;
14        }
15
16        return 0;
17      }
break [file_name:]line_number
break [file_name:]function_name
(gdb) break 10
Breakpoint 1 at 0x4004e5: file fibonacci.c, line 10.
info breakpoints
(gdb) info breakpoints
Num     Type           Disp Enb Address            What
1       breakpoint     keep y   0x00000000004004e5 in main at fibonacci.c:10
clear line_number
clear function_name
clear
(gdb) break 7
Breakpoint 2 at 0x4004e3: file fibonacci.c, line 7.
(gdb) clear 7
Deleted breakpoint 2
run
run argument…
(gdb) run
Starting program: /home/john/fibonacci

Breakpoint 1, main (argc=1, argv=0x7fffffffe4d8) at fibonacci.c:10
10          printf("%ld ", b);
print variable_name
(gdb) print a
$1 = 0
(gdb) print b
$2 = 1
continue
continue number
step
step number
(gdb) continue
Continuing.

Breakpoint 1, main (argc=1, argv=0x7fffffffe4d8) at fibonacci.c:10
10          printf("%ld ", b);
(gdb) step 3
13          b = sum;
(gdb) print sum
$3 = 2
scl enable devtoolset-1.1 'as [option...] -o object_file source_file'
scl enable devtoolset-1.1 'bash'
which as
as -v
scl enable devtoolset-1.1 'ld [option...] -o output_file object_file...'
scl enable devtoolset-1.1 'bash'
which ld
ld -v
scl enable devtoolset-1.1 'tool [option...] file_name'
scl enable devtoolset-1.1 'objdump [option...] object_file'
scl enable devtoolset-1.1 'bash'
which objdump
objdump -v
scl enable devtoolset-1.1 'man tool'
scl enable devtoolset-1.1 'tool [option...] file_name'
scl enable devtoolset-1.1 'eu-objdump [option...] object_file'
scl enable devtoolset-1.1 'bash'
which eu-objdump
eu-objdump -V
scl enable devtoolset-1.1 'dwz [option...] file_name'
scl enable devtoolset-1.1 'bash'
which dwz
dwz -v
scl enable devtoolset-1.1 'man dwz'
scl enable devtoolset-1.1 'stap-prep'
scl enable devtoolset-1.1 'tool [option...]'
scl enable devtoolset-1.1 'stap [option...] argument...'
scl enable devtoolset-1.1 'bash'
which stap
stap -V
scl enable devtoolset-1.1 'man stap'
scl enable devtoolset-1.1 'man staprun'
scl enable devtoolset-1.1 'valgrind [--tool=tool] program [option...]'
scl enable devtoolset-1.1 'valgrind --tool=cachegrind program [option...]'
scl enable devtoolset-1.1 'bash'
which valgrind
valgrind --version
scl enable devtoolset-1.1 'man valgrind'
scl enable devtoolset-1.1 'tool [option...]'
scl enable devtoolset-1.1 'ophelp -X'
scl enable devtoolset-1.1 'bash'
which opcontrol
opcontrol --version
scl enable devtoolset-1.1 'man oprofile'
scl enable devtoolset-1.1 'man tool'
yum groupinstall Eclipse
yum install eclipse-\*
scl enable devtoolset-1.1 'eclipse'
scl enable devtoolset-1.1 'bash'
which gcc
gcc -v
yum install sos
sosreport
__transaction_atomic { if (x < 10) y++; }
init(data);
__transaction_atomic { data_public = true;}  // data_public is initially false
__transaction_atomic { if (data_public) use(data); }
__transaction_atomic { temp = copy(data); if (data_public) use(temp); }
__transaction_atomic { data_public = false; }
destruct(data);
struct A { int *a; union { struct { int *a; }; }; };
error: ‘truncate’ was not declared in this scope
error: ‘sleep’ was not declared in this scope
error: ‘pipe’ was not declared in this scope
error: there are no arguments to 'offsetof' that depend on a template
parameter, so a declaration of 'offsetof' must be available
#include <unistd.h>
error: 'ptrdiff_t' does not name a type
error: 'size_t' has not been declared
error: 'NULL' was not declared in this scope
error: there are no arguments to 'offsetof' that depend on a template
parameter, so a declaration of 'offsetof' must be available
#include <cstddef>
template<typename T>
int t(T i)
{
  return f(i);
}

int f(int i)
{
  return i;
}

int main()
{
  return t(1);
}
In instantiation of ‘int t(T) [with T = int]’
required from here
error: ‘f’ was not declared in this scope, and no declarations were found by argument-dependent lookup at the point of instantiation [-fpermissive]
note: ‘int f(int)’ declared here, later in the translation unit
struct A { int a; A (); };
struct B : public A { };
const B b;
error: uninitialized const ‘b’ [-fpermissive]
note: ‘const struct B’ has no user-provided default constructor
#include <vector>               // template std::vector has default visibility
#include <ctime>                // struct tm has hidden visibility
template class std::vector<tm>; // instantiation has hidden visibility
#pragma GCC visibility push(default)
#include_next <foo.h>
#pragma GCC visibility push
const char *p = "foobar"__TIME__;
error: unable to find string literal operator ‘operator"" __TIME__’
struct S { S (); int i; };
void bar (S *);
void foo () { bar (&S ()); }
struct A { A(); };
struct B : A { int i; };
const B b = B();
void fn (void)
{
  int foo;
  foo = bar ();  /* foo is never used.  */
}
warning: variable "foo" set but not used [-Wunused-but-set-variable]
(gdb) target remote | ssh myhost gdbserver - hello
(gdb) print (enum E) 3
$1 = (ONE | TWO)

SKU	Subscription Name
RH2282403	Red Hat Enterprise Linux Developer Support, Professional
RH2264664	Red Hat Enterprise Linux Developer Support, Enterprise
RH2262474	Red Hat Enterprise Linux Developer Suite
RH3482727	Red Hat Enterprise Linux Developer Workstation, Professional
RH3413336	Red Hat Enterprise Linux Developer Workstation, Enterprise
RH3414706	30 day Self-Supported Red Hat Enterprise Linux Developer Workstation Evaluation
RH3474212	60 day Supported Red Hat Enterprise Linux Developer Workstation Evaluation
RH3437268	90 day Supported Red Hat Enterprise Linux Developer Workstation Evaluation
SER0402	1-year Unsupported Partner Evaluation Red Hat Enterprise Linux
SER0403	1-year Unsupported Red Hat Advanced Partner Subscription

Name	Description
`addr2line`	Translates addresses into file names and line numbers.
`ar`	Creates, modifies, and extracts files from archives.
`as`	The GNU assembler.
`c++filt`	Decodes mangled C++ symbols.
`elfedit`	Examines and edits ELF files.
`gprof`	Display profiling information.
`ld`	The GNU linker.
`ld.bfd`	An alternative to the GNU linker.
`ld.gold`	A new ELF linker.
`nm`	Lists symbols from object files.
`objcopy`	Copies and translates object files.
`objdump`	Displays information from object files.
`ranlib`	Generates an index to the contents of an archive to make access to this archive faster.
`readelf`	Displays information about ELF files.
`size`	Lists section sizes of object or archive files.
`strings`	Displays printable character sequences in files.
`strip`	Discards all symbols from object files.

Name	Description
`eu-addr2line`	Translates addresses into file names and line numbers.
`eu-ar`	Creates, modifies, and extracts files from archives.
`eu-elfcmp`	Compares relevant parts of two ELF files for equality.
`eu-elflint`	Verifies that ELF files are compliant with the generic ABI (gABI) and processor-specific supplement ABI (psABI) specification.
`eu-findtextrel`	Locates the source of text relocations in files.
`eu-make-debug-archive`	Creates an offline archive for debugging.
`eu-nm`	Lists symbols from object files.
`eu-objdump`	Displays information from object files.
`eu-ranlib`	Generates an index to the contents of an archive to make access to this archive faster.
`eu-readelf`	Displays information about ELF files.
`eu-size`	Lists section sizes of object or archive files.
`eu-strings`	Displays printable character sequences in files.
`eu-strip`	Discards all symbols from object files.
`eu-unstrip`	Combines stripped files with separate symbols and debug information.

Name	Description
`stap`	Translates probing instructions into C code, builds a kernel module, and loads it into a running Linux kernel.
`staprun`	Loads, unloads, attaches to, and detaches from kernel modules built with the `stap` utility.
`stapsh`	Serves as a remote shell for SystemTap.
`stap-prep`	Determines and—if possible—downloads the kernel information packages that are required to run SystemTap.
`stap-merge`	Merges per-CPU files. This script is automatically executed when the `stap` utility is executed with the `-b` command line option.
`stap-report`	Gathers important information about the system for the purpose of reporting a bug in SystemTap.

Name	Description
Memcheck	Detects memory management problems by intercepting system calls and checking all read and write operations.
Cachegrind	Identifies the sources of cache misses by simulating the level 1 instruction cache (I1), level 1 data cache (D1), and unified level 2 cache (L2).
Callgrind	Generates a call graph representing the function call history.
Helgrind	Detects synchronization errors in multithreaded C, C++, and Fortran programs that use POSIX threading primitives.
DRD	Detects errors in multithreaded C and C++ programs that use POSIX threading primitives or any other threading concepts that are built on top of these POSIX threading primitives.
Massif	Monitors heap and stack usage.

Name	Description
`oprofiled`	The OProfile daemon that collects profiling data.
`opcontrol`	Starts, stops, and configures the OProfile daemon.
`opannotate`	Generates an annotated source file or assembly listing form the profiling data.
`oparchive`	Generates a directory containing executable, debug, and sample files.
`opgprof`	Generates a summary of a profiling session in a format compatible with `gprof`.
`ophelp`	Displays a list of available events.
`opimport`	Converts a sample database file from a foreign binary format to the native format.
`opjitconv`	Converts a just-in-time (JIT) dump file to the Executable and Linkable Format (ELF).
`opreport`	Generates image and symbol summaries of a profiling session.

Option	Description
`-march=core2` and `-mtune=core2`	Optimization for Intel Core 2 processors.
`-march=corei7` and `-mtune=corei7`	Optimization for Intel Core i3, i5, and i7 processors.
`-march=corei7-avx` and `-mtune=corei7-avx`	Optimization for Intel Core i3, i5, and i7 processors with AVX.
`-march=core-avx-i`	Optimization for the Intel processor code-named Ivy Bridge with RDRND, FSGSBASE, and F16C.
`-march=core-avx2`	Optimization for a next-generation processor from Intel with AVX2, FMA, BMI, BMI2, and LZCNT.
`-march=bdver2` and `-mtune=bdver2`	Optimization for AMD family 15h processors code-named Piledriver.
`-march=btver1` and `-mtune=btver1`	Optimization for AMD family 14 processors code-named Bobcat.
`-march=bdver1` and `-mtune=bdver1`	Optimization for AMD family 15 processors code-named Bulldozer.

Option	Description
`-mavx2`	Support for Intel AVX2 intrinsics, built-in functions, and code generation.
`-mbmi2`	Support for Intel BMI2 intrinsics, built-in functions, and code generation.
`-mlzcnt`	Implementation and automatic generation of `__builtin_clz*` using the `lzcnt` instruction.
`-mfma`	Support for Intel FMA3 intrinsics and code generation.
`-mfsgsbase`	Enables the generation of new segment register read/write instructions through dedicated built-ins.
`-mrdrnd`	Support for the Intel `rdrnd` instruction.
`-mf16c`	Support for two additional AVX vector conversion instructions.
`-mtbm`	Support for TBM (Trailing Bit Manipulation) built-in functions and code generation.
`-mbmi`	Support for AMD's BMI (Bit Manipulation) built-in functions and code generation.
`-mcrc32`	Support for `crc32` intrinsics.
`-mmovbe`	Enables the use of the `movbe` instruction to implement `__builtin_bswap32` and `__builtin_bswap64`.
`-mxop`, `-mfma4`, and `-mlwp`	Support for the XOP, FMA4, and LWP instruction sets for the AMD Orochi processors.
`-mabm`	Enables the use of the `popcnt` and `lzcnt` instructions on AMD processors.
`-mpopcnt`	Enables the use of the `popcnt` instruction on both AMD and Intel processors.

User Guide

Installing and Using Red Hat Developer Toolset

Jaromír Hradílek

Jacquelynn East

Matt Newsome

Legal Notice

Preface

1. Document Conventions

1.1. Typographic Conventions

1.2. Pull-quote Conventions

1.3. Notes and Warnings

2. Getting Help and Giving Feedback

2.1. Do You Need Help?

2.2. We Need Feedback!

Part I. Introduction

Chapter 1. Red Hat Developer Toolset

1.1. About Red Hat Developer Toolset

1.2. Main Features

1.3. Compatibility

1.4. Getting Access to Red Hat Developer Toolset

1.4.1. Using RHN Classic

1.4.2. Using Red Hat Subscription Management

1.5. Installing Red Hat Developer Toolset

1.6. Updating Red Hat Developer Toolset

1.7. Uninstalling Red Hat Developer Toolset

1.8. Additional Resources

Online Documentation

See Also

Part II. Development Tools

Chapter 2. GNU Compiler Collection (GCC)

2.1. GNU C Compiler

2.1.1. Installing the C Compiler

2.1.2. Using the C Compiler

2.1.3. Running a C Program

2.2. GNU C++ Compiler

2.2.1. Installing the C++ Compiler

2.2.2. Using the C++ Compiler

2.2.3. Running a C++ Program

2.3. GNU Fortran Compiler

2.3.1. Installing the Fortran Compiler

2.3.2. Using the Fortran Compiler

2.3.3. Running a Fortran Program

2.4. Additional Resources

Installed Documentation

Online Documentation

See Also

Chapter 3. GNU Debugger (GDB)

3.1. Installing the GNU Debugger

3.2. Preparing a Program for Debugging

Compiling Programs with Debugging Information

Installing Debugging Information for Existing Packages

3.3. Running the GNU Debugger

3.4. Listing Source Code

3.5. Setting Breakpoints

Setting a New Breakpoint

Listing Breakpoints

Deleting Existing Breakpoints

3.6. Starting Execution

3.7. Displaying Current Values

3.8. Continuing Execution

3.9. Additional Resources

Online Documentation

See Also

Chapter 4. binutils

4.1. Installing binutils

4.2. Using the GNU Assembler

4.3. Using the GNU Linker

4.4. Using Other Binary Tools

4.5. Additional Resources

Installed Documentation

Online Documentation

See Also

Chapter 5. elfutils

5.1. Installing elfutils

5.2. Using elfutils

5.3. Additional Resources

See Also

Chapter 6. dwz

6.1. Installing dwz

6.2. Using dwz