Developer Guide

`Mono-spaced Bold Italic`

books        Desktop   documentation  drafts  mss    photos   stuff  svn
books_tests  Desktop1  downloads      images  notes  scripts  svgs
package org.jboss.book.jca.ex1;

import javax.naming.InitialContext;

public class ExClient
{
   public static void main(String args[]) 
       throws Exception
   {
      InitialContext iniCtx = new InitialContext();
      Object         ref    = iniCtx.lookup("EchoBean");
      EchoHome       home   = (EchoHome) ref;
      Echo           echo   = home.create();

      System.out.println("Created Echo");

      System.out.println("Echo.echo('Hello') = " + echo.echo("Hello"));
   }
}
std::vector(3)                                                  std::vector(3)

NAME
       std::vector -

       A standard container which offers fixed time access to individual
       elements in any order.

SYNOPSIS
       Inherits std::_Vector_base< _Tp, _Alloc >.

   Public Types
       typedef _Alloc allocator_type
       typedef __gnu_cxx::__normal_iterator< const_pointer, vector >
           const_iterator
       typedef _Tp_alloc_type::const_pointer const_pointer
       typedef _Tp_alloc_type::const_reference const_reference
       typedef std::reverse_iterator< const_iterator >

Help on module math:

NAME
	math

FILE
	/usr/lib64/python2.6/lib-dynload/mathmodule.so

DESCRIPTION
	This module is always available.  It provides access to the
	mathematical functions defined by the C standard.

FUNCTIONS
	acos[...]
		acos(x)

		Return the arc cosine (measured in radians) of x.

	acosh[...]
		acosh(x)

		Return the hyperbolic arc cosine (measured in radians) of x.

	asin(...)
		asin(x)

		Return the arc sine (measured in radians) of x.

	asinh[...]
		asinh(x)

		Return the hyperbolic arc sine (measured in radians) of x.

NAME
	CGI - Handle Common Gateway Interface requests and responses

SYNOPSIS
	use CGI;

	my $q = CGI->new;

[...]

DESCRIPTION
	CGI.pm is a stable, complete and mature solution for processing and preparing HTTP requests and responses.  Major features including processing form submissions, file uploads, reading and writing cookies, query string generation and manipulation, and processing and preparing HTTP headers. Some HTML generation utilities are included as well.

[...]

PROGRAMMING STYLE
		There are two styles of programming with CGI.pm, an object-oriented style and a function-oriented style.  In the object-oriented style you create one or more CGI objects and then use object methods to create the various elements of the page.  Each CGI object starts out with the list of named parameters that were passed to your CGI script by the server.  

[...]

split /PATTERN/,EXPR,LIMIT
split /PATTERN/,EXPR
split /PATTERN/
split   Splits the string EXPR into a list of strings and returns that list.  By default, empty leading fields are preserved, and empty trailing ones are deleted.  (If all fields are empty, they are considered to be trailing.)

In scalar context, returns the number of fields found. In scalar and void context it splits into the @_ array.  Use of split in scalar and void context is deprecated, however, because it clobbers your subroutine arguments.

If EXPR is omitted, splits the $_ string.  If PATTERN is also omitted, splits on whitespace (after skipping any leading whitespace).  Anything matching PATTERN is taken to be a delimiter separating the fields.  (Note that the delimiter may be longer than one character.)

[...]

#include <stdio.h>

int main ()
{
  printf ("Hello world!\n");
  return 0;
}

#include <iostream>

using namespace std;

int main(void)
{
  cout << "Hello World!" << endl;
  return 0;
}

#include <stdio.h>
void hello()
{
  printf("Hello world!\n");
}

extern void hello();

int main()
{
  hello();
  return 0;
}

$ gcc -frecord-gcc-switches -O3 -Wall hello.c -o hello
$ readelf --string-dump=.GCC.command.line hello

String dump of section '.GCC.command.line':
  [     0]  hello.c
  [     8]  -mtune=generic
  [    17]  -O3
  [    1b]  -Wall
  [    21]  -frecord-gcc-switches

$ file hello64
hello64: ELF 64-bit LSB executable, x86-64, version 1 (GNU/Linux), dynamically linked (uses shared libs), for GNU/Linux 2.6.18, not stripped
$ ldd hello64
linux-vdso.so.1 =>  (0x00007fff242dd000)
libc.so.6 => /lib64/libc.so.6 (0x00007f0721514000)
/lib64/ld-linux-x86-64.so.2 (0x00007f0721893000)

$ file hello32
hello32: ELF 32-bit LSB executable, Intel 80386, version 1 (GNU/Linux), dynamically linked (uses shared libs), for GNU/Linux 2.6.18, not stripped
$ ldd hello32
linux-gate.so.1 =>  (0x007eb000)
libc.so.6 => /lib/libc.so.6 (0x00b13000)
/lib/ld-linux.so.2 (0x00cd7000)

$ gcc -m32 hello32.c -o hello32
/usr/bin/ld: crt1.o: No such file: No such file or directory
collect2: ld returned 1 exit status

$ g++ -m32 hello32.cc -o hello32-c++
In file included from /usr/include/features.h:385,
     from /usr/lib/gcc/x86_64-redhat-linux/4.4.4/../../../../include/c++/4.4.4/x86_64-redhat-linux/32/bits/os_defines.h:39,
     from /usr/lib/gcc/x86_64-redhat-linux/4.4.4/../../../../include/c++/4.4.4/x86_64-redhat-linux/32/bits/c++config.h:243,
     from /usr/lib/gcc/x86_64-redhat-linux/4.4.4/../../../../include/c++/4.4.4/iostream:39,
     from hello32.cc:1:
/usr/include/gnu/stubs.h:7:27: error: gnu/stubs-32.h: No such file or directory

#include <stdio.h>

    char hello[] = { "Hello, World!" };

    int
    main()
    {
      fprintf (stdout, "%s\n", hello);
      return (0);
    }
(gdb)
    gdb) p hello
    $1 = "Hello, World!"
    (gdb) p hello[0]
    $2 = 72 'H'
    (gdb) p *hello
    $3 = 72 'H'
    (gdb)

    (gdb) p *(hello + 1)
    $4 = 101 'e'

    (gdb) l
    1       #include <stdio.h>
    2
    3       char hello[] = { "Hello, World!" };
    4
    5       int
    6       main()
    7       {
    8         fprintf (stdout, "%s\n", hello);
    9         return (0);
    10      }

    (gdb) br 8
    Breakpoint 1 at 0x80483ed: file hello.c, line 8.
    (gdb) r
    Starting program: /home/moller/tinkering/gdb-manual/hello

    Breakpoint 1, main () at hello.c:8
    8         fprintf (stdout, "%s\n", hello);

    (gdb) n
    Hello, World!
    9         return (0);

      #include <stdio.h>

      main()
      {
        int i;

        for (i = 0;; i++) {
          fprintf (stdout, "i = %d\n", i);
        }
      }

      (gdb) br 8 if i == 8936
      Breakpoint 1 at 0x80483f5: file iterations.c, line 8.
      (gdb) r

      i = 8931
      i = 8932
      i = 8933
      i = 8934
      i = 8935

      Breakpoint 1, main () at iterations.c:8
      8           fprintf (stdout, "i = %d\n", i);

      (gdb) info br
      Num     Type           Disp Enb Address    What
      1       breakpoint     keep y   0x080483f5 in main at iterations.c:8
              stop only if i == 8936
              breakpoint already hit 1 time

Performance counter stats for 'make all':

  244011.782059  task-clock-msecs         #      0.925 CPUs 
          53328  context-switches         #      0.000 M/sec
            515  CPU-migrations           #      0.000 M/sec
        1843121  page-faults              #      0.008 M/sec
   789702529782  cycles                   #   3236.330 M/sec
  1050912611378  instructions             #      1.331 IPC  
   275538938708  branches                 #   1129.203 M/sec
     2888756216  branch-misses            #      1.048 %    
     4343060367  cache-references         #     17.799 M/sec
      428257037  cache-misses             #      1.755 M/sec

  263.779192511  seconds time elapsed

[ perf record: Woken up 42 times to write data ]
[ perf record: Captured and wrote 9.753 MB perf.data (~426109 samples) ]

# Samples: 1083783860000
#
# Overhead          Command
# ........  ...............
#
    48.19%         xsltproc
    44.48%        pdfxmltex
     6.01%             make
     0.95%             perl
     0.17%       kernel-doc
     0.05%          xmllint
     0.05%              cc1
     0.03%               cp
     0.01%            xmlto
     0.01%               sh
     0.01%          docproc
     0.01%               ld
     0.01%              gcc
     0.00%               rm
     0.00%              sed
     0.00%   git-diff-files
     0.00%             bash
     0.00%   git-diff-index

comm: xsltproc
# Samples: 472520675377
#
# Overhead  Samples                    Shared Object  Symbol
# ........ ..........  .............................  ......
#
    45.54%215179861044  libxml2.so.2.7.6               [.] xmlXPathCmpNodesExt
    11.63%54959620202  libxml2.so.2.7.6               [.] xmlXPathNodeSetAdd__internal_alias
     8.60%40634845107  libxml2.so.2.7.6               [.] xmlXPathCompOpEval
     4.63%21864091080  libxml2.so.2.7.6               [.] xmlXPathReleaseObject
     2.73%12919672281  libxml2.so.2.7.6               [.] xmlXPathNodeSetSort__internal_alias
     2.60%12271959697  libxml2.so.2.7.6               [.] valuePop
     2.41%11379910918  libxml2.so.2.7.6               [.] xmlXPathIsNaN__internal_alias
     2.19%10340901937  libxml2.so.2.7.6               [.] valuePush__internal_alias

power wakeup irqsoff function sysprof sched_switch initcall nop

Package Name	6	5	4
glibc	2.12	2.5	2.3
libstdc++	4.4	4.1	3.4
boost	1.41	1.33	1.32
java	1.5 (IBM), 1.6 (IBM, OpenJDK)	1.4, 1.5, and 1.6	1.4
python	2.6	2.4	2.3
php	5.3	5.1	4.3
ruby	1.8	1.8	1.8
httpd	2.2	2.2	2.0
postgresql	8.4	8.1	7.4
mysql	5.1	5.0	4.1
nss	3.12	3.12	3.12
openssl	1.0.0	0.9.8e	0.9.7a
libX11	1.3	1.0
firefox	3.6	3.6	3.6
kdebase	4.3	3.5	3.3
gtk2	2.18	2.10	2.04

Developer Guide

An introduction to application development tools in Red Hat Enterprise Linux 6

Edited by

Don Domingo

Edited by

Jacquelynn East

Red Hat Subject Matter Experts

Dave Brolley

William Cohen

Roland Grunberg

Aldy Hernandez

Karsten Hopp

Jakub Jelinek

Jeff Johnston

Benjamin Kosnik

Aleksander Kurtakov

Chris Moller

Phil Muldoon

Andrew Overholt

Charley Wang

Development Community

Kent Sebastian

Legal Notice

Abstract

Preface

1. Document Conventions

1.1. Typographic Conventions

1.2. Pull-quote Conventions

1.3. Notes and Warnings

Note

Important

Warning

2. Getting Help and Giving Feedback

2.1. Do You Need Help?

2.2. We Need Feedback!

Chapter 1. Introduction to Eclipse

1.1. Understanding Eclipse Projects

Figure 1.1. Workspace Launcher

Figure 1.2. New Project Wizard

Figure 1.3. Import Wizard

1.2. Help In Eclipse

Figure 1.4. Help

Figure 1.5. Help Menu

Figure 1.6. Dynamic Help

1.3. Development Toolkits

Chapter 2. The Eclipse Integrated Development Environment (IDE)

2.1. User Interface

Figure 2.1. Eclipse User Interface (default)

Figure 2.2. Eclipse Editor

Figure 2.3. Project Explorer

Figure 2.4. Outline Window

Figure 2.5. Console View

Figure 2.6. Tasks View

Figure 2.7. Sample of Tracked Comment

Figure 2.8. Task Properties

Figure 2.9. Problems View

2.2. Useful Hints

2.2.1. The quick access menu

Figure 2.10. Quick Access Menu

Figure 2.11. Keyboard Shortcuts

Figure 2.12. Configuring Keyboard Shortcuts

Figure 2.13. Customize Perspective Menu

Figure 2.14. Toolbar

Figure 2.15. Menu Visibility Tab

Figure 2.16. Command Group Availability Tab

Figure 2.17. Shortcuts Tab

2.2.2. libhover Plug-in

2.2.2.1. Setup and Usage

Figure 2.18. Enabling/Disabling Hover Help

Figure 2.19. Using Hover Help

Figure 2.20. Using Code Completion

Chapter 3. Libraries and Runtime Support

3.1. Version Information

Table 3.1. Language and Runtime Library Versions

3.2. Compatibility

3.2.1. API Compatibility

3.2.2. ABI Compatibility

3.2.3. Policy

3.2.4. Static Linking

3.3. Library and Runtime Details