Top Description Inners Fields Constructors Methods
org.jruby.util.io

public Class PopenExecutor

extends Object
Class Inheritance
Imports
jnr.constants.platform.Errno, .Fcntl, .OpenFlags, .RLIMIT, jnr.enxio.channels.NativeDeviceChannel, jnr.posix.SpawnAttribute, .SpawnFileAction, org.jcodings.transcode.EConvFlags, org.jruby.Ruby, .RubyArray, .RubyBasicObject, .RubyClass, .RubyFile, .RubyFixnum, .RubyHash, .RubyIO, .RubyNumeric, .RubyProcess, .RubyString, .RubySymbol, org.jruby.api.API, org.jruby.exceptions.RaiseException, org.jruby.ext.fcntl.FcntlLibrary, org.jruby.platform.Platform, org.jruby.runtime.Arity, .Block, .ThreadContext, org.jruby.runtime.builtin.IRubyObject, org.jruby.util.ByteList, .ShellLauncher, .TypeConverter, org.jruby.util.cli.Options, java.io.File, java.util.ArrayList, .Arrays, .Collections, .Comparator, .List, .Map, .Set
Port of MRI's popen+exec logic.

Nested and Inner Type Summary

Modifier and TypeClass and Description
private static class
PopenExecutor.ArgvStr

public static class
PopenExecutor.ExecArg

private static class
PopenExecutor.PopenArg

private static class
PopenExecutor.run_exec_dup2_fd_pair

private static class
PopenExecutor.StringComparator

Field Summary

Modifier and TypeField and Description
private static final byte[]
DUMMY_ARRAY

private Errno
errno

private static final Comparator<PopenExecutor.run_exec_dup2_fd_pair>
intcmp

private static final Comparator<PopenExecutor.run_exec_dup2_fd_pair>
intrcmp

private static final int
posix_sh_cmd_length

private static final String[]
posix_sh_cmds

public static final int
SH_CHDIR_ARG_COUNT

private static final int
ST_CONTINUE

private static final int
ST_STOP

Constructor Summary

AccessConstructor and Description
public
PopenExecutor()

Method Summary

Modifier and TypeMethod and Description
private static String[]
ARGVSTR2ARGV(byte[][] argv_str)

private static void
buildEnvp(ThreadContext context, PopenExecutor.ExecArg eargp, RubyHash envTable)

public static RubyString
checkArgv(ThreadContext context, IRubyObject[] argv)

public static RubyArray<T extends IRubyObject>
checkExecEnv(ThreadContext context, RubyHash hash, PopenExecutor.ExecArg pathArg)

pack-priv static IRubyObject
checkExecFds(ThreadContext context, PopenExecutor.ExecArg eargp)

pack-priv static int
checkExecFds1(ThreadContext context, PopenExecutor.ExecArg eargp, RubyHash h, int maxhint, IRubyObject ary)

pack-priv static void
checkExecOptions(ThreadContext context, RubyHash opthash, PopenExecutor.ExecArg eargp)

pack-priv static void
checkExecRedirect(ThreadContext context, IRubyObject key, IRubyObject val, PopenExecutor.ExecArg eargp)

pack-priv static RubyArray<T extends IRubyObject>
checkExecRedirect1(ThreadContext context, RubyArray<T extends IRubyObject> ary, IRubyObject key, IRubyObject param)

private static void
checkExecRedirectDefault(ThreadContext context, IRubyObject key, IRubyObject val, PopenExecutor.ExecArg eargp)

pack-priv static IRubyObject
checkExecRedirectFd(ThreadContext context, IRubyObject v, boolean iskey)

public static IRubyObject
checkPipeCommand(ThreadContext context, IRubyObject filenameOrCommand)

private static String
dlnFindExeR(ThreadContext context, String fname, IRubyObject path)

private long
DO_SPAWN(ThreadContext context, PopenExecutor.ExecArg eargp, String cmd, String[] args, String[] envp)

pack-priv static int
execargAddopt(ThreadContext context, PopenExecutor.ExecArg eargp, IRubyObject key, IRubyObject val)

pack-priv static IRubyObject
execargExtractOptions(ThreadContext context, PopenExecutor.ExecArg eargp, RubyHash opthash)

pack-priv static void
execargFixup(ThreadContext context, PopenExecutor.ExecArg eargp)

private static RubyString
execargInit(ThreadContext context, IRubyObject[] argv, IRubyObject optForChdir, boolean accept_shell, PopenExecutor.ExecArg eargp, boolean allow_exc_opt)

public static PopenExecutor.ExecArg
execargNew(ThreadContext context, IRubyObject[] argv, IRubyObject optForChdir, boolean accept_shell, boolean allow_exc_opt)

pack-priv static void
execargParentStart(ThreadContext context, PopenExecutor.ExecArg eargp)

pack-priv static void
execargParentStart1(ThreadContext context, PopenExecutor.ExecArg eargp)

pack-priv int
execargRunOptions(ThreadContext context, PopenExecutor.ExecArg eargp, PopenExecutor.ExecArg sargp, String[] errmsg)

pack-priv static void
execargSetenv(ThreadContext context, PopenExecutor.ExecArg eargp, IRubyObject env)

private static void
execFillarg(ThreadContext context, RubyString prog, IRubyObject[] argv, IRubyObject env, IRubyObject opthash, PopenExecutor.ExecArg eargp)

private static RubyString
execGetargs(ThreadContext context, IRubyObject[][] argv_p, boolean accept_shell, IRubyObject[] env_opt)

pack-priv static IRubyObject
handleOptionsCommon(ThreadContext context, PopenExecutor.ExecArg eargp, RubyHash opthash, boolean raise)

pack-priv static boolean
isPopenFork(ThreadContext context, RubyString prog)

public static boolean

Returns:

true if popen can use native code, false otherwise
nativePopenAvailable(Ruby
current runtime
runtime)

Check properties and runtime state to determine whether a native popen is possible.

pack-priv static ChannelFD
open_func(Ruby runtime, RubyIO.Sysopen data)

pack-priv static void
parentRedirectClose(Ruby runtime, int fd)

pack-priv static ChannelFD
parentRedirectOpen(Ruby runtime, RubyIO.Sysopen data)

public static IRubyObject
pipeOpen(ThreadContext context, IRubyObject prog, String modestr, int fmode, IOEncodable convconfig)

private RubyIO
pipeOpen(ThreadContext context, PopenExecutor.ExecArg eargp, String modestr, int fmode, IOEncodable convconfig)

public static IRubyObject
popen(ThreadContext context, IRubyObject[] argv, RubyClass klass, Block block)

private void
prepareStdioRedirects(ThreadContext context, int[] readPipe, int[] writePipe, PopenExecutor.ExecArg eargp)

pack-priv long
procSpawnCmd(ThreadContext context, String[] argv, String prog, PopenExecutor.ExecArg eargp)

pack-priv long
procSpawnCmdInternal(ThreadContext context, String[] argv, String prog, PopenExecutor.ExecArg eargp)

pack-priv long
procSpawnSh(ThreadContext context, String str, PopenExecutor.ExecArg eargp)

private long
procSpawnSh(ThreadContext context, PopenExecutor.ExecArg eargp, String str, String[] envp)

pack-priv static int
redirectClearCloexec(ThreadContext context, int oldfd)

pack-priv static int
redirectCloexecDup(ThreadContext context, int oldfd)

pack-priv static void
redirectClose(PopenExecutor.ExecArg eargp, int fd)

pack-priv static int
redirectDup(ThreadContext context, int oldfd)

pack-priv static void
redirectDup2(ThreadContext context, PopenExecutor.ExecArg eargp, int oldfd, int newfd)

pack-priv static void
redirectOpen(PopenExecutor.ExecArg eargp, int fd, String pathname, int flags, int perm)

pack-priv static void
run_exec_close(ThreadContext context, RubyArray<T extends IRubyObject> ary, PopenExecutor.ExecArg eargp)

pack-priv static int
run_exec_dup2(ThreadContext context, RubyArray<T extends IRubyObject> ary, PopenExecutor.ExecArg eargp, PopenExecutor.ExecArg sargp, String[] errmsg)

pack-priv static void
run_exec_dup2_child(ThreadContext context, RubyArray<T extends IRubyObject> ary, PopenExecutor.ExecArg eargp)

Add spawn configuration for duplicating descriptors in the child

pack-priv static void
run_exec_open(ThreadContext context, RubyArray<RubyArray<T extends IRubyObject>> ary, PopenExecutor.ExecArg eargp)

pack-priv static int
run_exec_pgroup(ThreadContext context, PopenExecutor.ExecArg eargp, PopenExecutor.ExecArg sargp, String[] errmsg)

pack-priv static int
run_exec_rlimit(Ruby runtime, RubyArray<T extends IRubyObject> ary, PopenExecutor.ExecArg sargp, String[] errmsg)

pack-priv static int
runExecDup2TmpbufSize(int n)

pack-priv static void
saveEnv(ThreadContext context, Ruby runtime, PopenExecutor.ExecArg sargp)

pack-priv static int
saveRedirectFd(ThreadContext context, int fd, PopenExecutor.ExecArg sargp, String[] errmsg)

private static boolean
searchForMetaChars(RubyString prog)

Search for meta characters in the command, to know whether we should use a shell to launch.

public static RubyFixnum
spawn(ThreadContext context, IRubyObject[] argv)

pack-priv long
spawnProcess(ThreadContext context, PopenExecutor.ExecArg eargp, String[] errmsg)

public IRubyObject
systemInternal(ThreadContext context, IRubyObject[] argv, String[] errmsg)

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait