src/org/jruby/RubySignal.java

   1 /***** BEGIN LICENSE BLOCK *****
   2  * Version: CPL 1.0/GPL 2.0/LGPL 2.1
   3  *
   4  * The contents of this file are subject to the Common Public
   5  * License Version 1.0 (the "License"); you may not use this file
   6  * except in compliance with the License. You may obtain a copy of
   7  * the License at http://www.eclipse.org/legal/cpl-v10.html
   8  *
   9  * Software distributed under the License is distributed on an "AS
  10  * IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
  11  * implied. See the License for the specific language governing
  12  * rights and limitations under the License.
  13  *
  14  * Copyright (C) 2007 Ola Bini <ola@ologix.com>
  15  *
  16  * Alternatively, the contents of this file may be used under the terms of
  17  * either of the GNU General Public License Version 2 or later (the "GPL"),
  18  * or the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
  19  * in which case the provisions of the GPL or the LGPL are applicable instead
  20  * of those above. If you wish to allow use of your version of this file only
  21  * under the terms of either the GPL or the LGPL, and not to allow others to
  22  * use your version of this file under the terms of the CPL, indicate your
  23  * decision by deleting the provisions above and replace them with the notice
  24  * and other provisions required by the GPL or the LGPL. If you do not delete
  25  * the provisions above, a recipient may use your version of this file under
  26  * the terms of any one of the CPL, the GPL or the LGPL.
  27  ***** END LICENSE BLOCK *****/
  28 package org.jruby;
  29
  30 import org.jruby.anno.JRubyMethod;
  31 import org.jruby.anno.JRubyModule;
  32 import org.jruby.javasupport.util.RuntimeHelpers;
  33 import org.jruby.runtime.Block;
  34 import org.jruby.runtime.CallType;
  35 import org.jruby.runtime.ThreadContext;
  36 import org.jruby.runtime.builtin.IRubyObject;
  37
  38 import org.jruby.util.SignalFacade;
  39 import org.jruby.util.NoFunctionalitySignalFacade;
  40
  41 @JRubyModule(name="Signal")
  42 public class RubySignal {
  43     private final static SignalFacade SIGNALS = getSignalFacade();
  44
  45     private final static SignalFacade getSignalFacade() {
  46         try {
  47             Class realFacadeClass = Class.forName("org.jruby.util.SunSignalFacade");
  48             return (SignalFacade)realFacadeClass.newInstance();
  49         } catch(Throwable e) {
  50             return new NoFunctionalitySignalFacade();
  51         }
  52     }
  53
  54     // NOTE: The indicies here match exactly the signal values; do not reorder
  55     public static final String[] NAMES = {
  56             "EXIT", "HUP", "INT", "QUIT", "ILL", "TRAP", "ABRT", "EMT",
  57             "FPE", "KILL", "BUS", "SEGV", "SYS", "PIPE", "ALRM", "TERM", "URG",
  58             "STOP", "TSTP", "CONT", "CHLD", "TTIN", "TTOU", "IO", "XCPU",
  59             "XFSZ", "VTALRM", "PROF", "WINCH", "INFO", "USR1", "USR2"};
  60
  61     public static void createSignal(Ruby runtime) {
  62         RubyModule mSignal = runtime.defineModule("Signal");
  63
  64         mSignal.defineAnnotatedMethods(RubySignal.class);
  65     }
  66
  67     @JRubyMethod(name = "trap", required = 1, optional = 1, frame = true, meta = true)
  68     public static IRubyObject trap(ThreadContext context, IRubyObject recv, IRubyObject[] args, Block block) {
  69         Ruby runtime = recv.getRuntime();
  70         runtime.getLoadService().require("jsignal");
  71         return RuntimeHelpers.invoke(context, runtime.getKernel(), "__jtrap", args, block);
  72     }
  73
  74     @JRubyMethod(name = "list", meta = true)
  75     public static IRubyObject list(ThreadContext context, IRubyObject recv) {
  76         Ruby runtime = recv.getRuntime();
  77         RubyHash names = RubyHash.newHash(runtime);
  78         for (int i = 0; i < NAMES.length; i++) {
  79             names.op_aset(context, runtime.newString(NAMES[i]), runtime.newFixnum(i));
  80         }
  81         // IOT is also 6
  82         names.op_aset(context, runtime.newString("IOT"), runtime.newFixnum(6));
  83         // CLD is also 20
  84         names.op_aset(context, runtime.newString("CLD"), runtime.newFixnum(20));
  85         return names;
  86     }
  87
  88     @JRubyMethod(name = "__jtrap_kernel", required = 3,meta = true)
  89     public static IRubyObject __jtrap_kernel(final IRubyObject recv, IRubyObject arg1, IRubyObject arg2, IRubyObject arg3) {
  90         return SIGNALS.trap(recv, arg1, arg2, arg3);
  91     }
  92 }// RubySignal