1#@!#!123s

: / proc / self / root / opt / alt / ruby34 / share / ri / system / Kernel /
Filename : exec-i.ri
back
U:RDoc::AnyMethod[iI"	exec:ETI"Kernel#exec;TF:publico:RDoc::Markup::Document:@parts[7o:RDoc::Markup::Paragraph;	[I"@Replaces the current process by doing one of the following:;To:RDoc::Markup::BlankLine�o:RDoc::Markup::List:
@type:BULLET:@items[o:RDoc::Markup::ListItem:@label0;	[o;
;	[I"0Passing string +command_line+ to the shell.;To;;0;	[o;
;	[I"+Invoking the executable at +exe_path+.;T@o;
;	[I"XThis method has potential security vulnerabilities if called with untrusted input; ;TI">see {Command Injection}[rdoc-ref:command_injection.rdoc].;T@o;
;	[	I"*The new process is created using the ;TI"m{exec system call}[https://pubs.opengroup.org/onlinepubs/9699919799.2018edition/functions/execve.html]; ;TI"Eit may inherit some of its environment from the calling program ;TI"0(possibly including open file descriptors).;T@o;
;	[I"QArgument +env+, if given, is a hash that affects +ENV+ for the new process; ;TI"Isee {Execution Environment}[rdoc-ref:Process@Execution+Environment].;T@o;
;	[I"BArgument +options+ is a hash of options for the new process; ;TI"Asee {Execution Options}[rdoc-ref:Process@Execution+Options].;T@o;
;	[I"9The first required argument is one of the following:;T@o;;
;;[o;;0;	[o;
;	[I"'+command_line+ if it is a string, ;TI"Fand if it begins with a shell reserved word or special built-in, ;TI"3or if it contains one or more meta characters.;To;;0;	[o;
;	[I"+exe_path+ otherwise.;T@o;
;	[I"#<b>Argument +command_line+</b>;T@o;
;	[I"P\String argument +command_line+ is a command line to be passed to a shell; ;TI"Nit must begin with a shell reserved word, begin with a special built-in, ;TI" or contain meta characters:;T@o:RDoc::Markup::Verbatim;	[I"Aexec('if true; then echo "Foo"; fi') # Shell reserved word.
;TI"6exec('exit')                         # Built-in.
;TI"Eexec('date > date.tmp')              # Contains meta character.
;T:@format0o;
;	[I"MThe command line may also contain arguments and options for the command:;T@o;;	[I"exec('echo "Foo"')
;T;0o;
;	[I"Output:;T@o;;	[I"	Foo
;T;0o;
;	[I"YSee {Execution Shell}[rdoc-ref:Process@Execution+Shell] for details about the shell.;T@o;
;	[I">Raises an exception if the new process could not execute.;T@o;
;	[I"<b>Argument +exe_path+</b>;T@o;
;	[I"1Argument +exe_path+ is one of the following:;T@o;;
;;[o;;0;	[o;
;	[I"3The string path to an executable to be called.;To;;0;	[o;
;	[I"<A 2-element array containing the path to an executable ;TI"Dand the string to be used as the name of the executing process.;T@o;
;	[I"
Example:;T@o;;	[I"exec('/usr/bin/date')
;T;0o;
;	[I"Output:;T@o;;	[I"%Sat Aug 26 09:38:00 AM CDT 2023
;T;0o;
;	[I"+Ruby invokes the executable directly. ;TI"'This form does not use the shell; ;TI"Gsee {Arguments args}[rdoc-ref:Process@Arguments+args] for caveats.;T@o;;	[I"1exec('doesnt_exist') # Raises Errno::ENOENT
;T;0o;
;	[I"CIf one or more +args+ is given, each is an argument or option ;TI"$to be passed to the executable:;T@o;;	[I"exec('echo', 'C*')
;TI"$exec('echo', 'hello', 'world')
;T;0o;
;	[I"Output:;T@o;;	[I"C*
;TI"hello world
;T;0o;
;	[I">Raises an exception if the new process could not execute.;T:
@fileI"process.c;T:0@omit_headings_from_table_of_contents_below0I"[exec([env, ] command_line, options = {})
exec([env, ] exe_path, *args, options  = {})
;T0[�I"(*args);T@�FI"Kernel;TcRDoc::NormalModule00