Mercurial Mercurial > upstream > oracle > userland-gate / annotate
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
components/ruby/ruby-18/patches/04-ruby_1.patch
author April Chin <april.chin@oracle.com>
Wed, 06 Nov 2013 14:12:13 -0800
branchs11-update
changeset 2813 db0bfa0fa498
parent 199 components/ruby/patches/04-ruby_1.patch@b87534be1a76
permissions -rw-r--r--
PSARC/2013/269 Add Ruby 1.9.3 and EOF and Remove Ruby 1.8.7 15700054 SUNBT7023596 integrate ruby version 1.9.3 17650189 problem in UTILITY/RUBY
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
199
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
     1
 
--- ruby-1.8.7-p334/ruby.1	2007-02-12 15:01:19.000000000 -0800
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
     2
 
+++ ruby-1.8.7-p334/../ruby.1	2008-02-28 03:00:23.255784000 -0800
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
     3
 
@@ -104,8 +104,79 @@
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
     4
 
 .Ux
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
     5
 
 systems, you can load object files into the Ruby interpreter
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
     6
 
 on-the-fly.
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
     7
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
     8
 
+.It Sy "DTrace Probes"
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
     9
 
+Ruby has a set of DTrace probes that can be used to debug a running Ruby/Rails
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    10
 
+application. NOTE: This is on x86/x64 platform only.
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    11
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    12
 
+.Nm function-entry
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    13
 
+.Nd Probe that fires when a Ruby method is entered
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    14
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    15
 
+.Nm function-return
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    16
 
+.Nd Probe that fires when a Ruby method returns
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    17
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    18
 
+.Nm raise
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    19
 
+.Nd Probe that fires when a Ruby exception is raised
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    20
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    21
 
+.Nm rescue
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    22
 
+.Nd Probe that fires when a Ruby exception is rescued
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    23
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    24
 
+.Nm line
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    25
 
+.Nd Probe that fires for every line of Ruby executed
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    26
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    27
 
+.Nm gc-begin
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    28
 
+.Nd Probe that fires right before a GC cycle begins
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    29
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    30
 
+.Nm gc-end
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    31
 
+.Nd Probe that fires right after a GC cycle finishes
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    32
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    33
 
+.Nm object-create-start
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    34
 
+.Nd Probe that fires directly before a Ruby object is allocated
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    35
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    36
 
+.Nm object-create-done
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    37
 
+.Nd Probe that fires when Ruby is finished allocating an object
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    38
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    39
 
+.Nm object-free
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    40
 
+.Nd Probe that fires every time a Ruby object is freed
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    41
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    42
 
+.Nm ruby-probe
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    43
 
+.Nd Probe that can be fired from Ruby code (see below)
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    44
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    45
 
+.Sy "Probe Arguments"
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    46
 
 .El
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    47
 
 .Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    48
 
+.Nm function-entry
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    49
 
+.Ar "Ruby class" Ar "Method name" Ar "Source file" Ar "Line number"
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    50
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    51
 
+.Nm function-return
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    52
 
+.Ar "Ruby class" Ar "Method name" Ar "Source file" Ar "Line number"
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    53
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    54
 
+.Nm raise
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    55
 
+.Ar "Ruby class" Ar "Source file" Ar "Line number"
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    56
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    57
 
+.Nm rescue
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    58
 
+.Ar "Source file" Ar "Line number"
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    59
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    60
 
+.Nm line
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    61
 
+.Ar "Source file" Ar "Line number"
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    62
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    63
 
+.Nm gc-begin
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    64
 
+.Ar ""
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    65
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    66
 
+.Nm gc-end
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    67
 
+.Ar ""
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    68
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    69
 
+.Nm object-create-start
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    70
 
+.Ar "Ruby type" Ar "Source file" Ar "Line number"
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    71
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    72
 
+.Nm object-create-done
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    73
 
+.Ar "Ruby type" Ar "Source file" Ar "Line number"
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    74
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    75
 
+.Nm object-free
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    76
 
+.Ar "Ruby type"
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    77
 
+.Nm ruby-probe
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    78
 
+.Ar "Arbitrary string" Ar "Arbitrary string"
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    79
 
+.Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    80
 
 .Sh OPTIONS
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    81
 
 Ruby interpreter accepts following command-line options (switches).
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    82
 
 They are quite similar to those of
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    83
 
@@ -154,9 +225,9 @@
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    84
 
 .Li #!
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    85
 
 on machines that don't support it, in the following manner:
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    86
 
 .Bd -literal -offset indent
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    87
 
-#! /usr/local/bin/ruby
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    88
 
+#! /usr/bin/ruby
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    89
 
 # This line makes the next one a comment in Ruby \e
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    90
 
-  exec /usr/local/bin/ruby -S $0 $*
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    91
 
+  exec /usr/bin/ruby -S $0 $*
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    92
 
 .Ed
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    93
 
 .Pp
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    94
 
 .It Fl T Ns Op Ar level
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    95
 
@@ -251,7 +322,7 @@
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    96
 
 .Li ARGV
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    97
 
 and set the corresponding variable in the script.  For example:
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    98
 
 .Bd -literal -offset indent
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
    99
 
-#! /usr/local/bin/ruby -s
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
   100
 
+#! /usr/bin/ruby -s
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
   101
 
 # prints "true" if invoked with `-xyz' switch.
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
   102
 
 print "true\en" if $xyz
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
   103
 
 .Ed
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
   104
 
@@ -349,3 +420,5 @@
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
   105
 
 .Sh AUTHORS
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
   106
 
 Ruby is designed and implemented by
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
   107
 
 .An Yukihiro Matsumoto Aq [email protected] .
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
   108
 
+.Sh SEE ALSO
b87534be1a76 7023222 move ruby to userland
April Chin <april.chin@oracle.com>
parents:
diff changeset 
   109
 
+.Nm gem(1)
upstream/oracle/userland-gate