Module: PhusionPassenger::PlatformInfo

Defined in:
lib/phusion_passenger/platform_info.rb,
lib/phusion_passenger/platform_info/curl.rb,
lib/phusion_passenger/platform_info/ruby.rb,
lib/phusion_passenger/platform_info/zlib.rb,
lib/phusion_passenger/platform_info/linux.rb,
lib/phusion_passenger/platform_info/apache.rb,
lib/phusion_passenger/platform_info/compiler.rb,
lib/phusion_passenger/platform_info/depcheck.rb,
lib/phusion_passenger/platform_info/apache_detector.rb,
lib/phusion_passenger/platform_info/cxx_portability.rb,
lib/phusion_passenger/platform_info/operating_system.rb,
lib/phusion_passenger/platform_info/binary_compatibility.rb

Overview

Users can change the detection behavior by setting the environment variable APXS2 to the correct ‘apxs’ (or ‘apxs2’) binary, as provided by Apache.

Defined Under Namespace

Modules: Depcheck Classes: ApacheDetector, RuntimeError

Constant Summary collapse

GEM_HOME = 
gem_home
RUBY_ENGINE = 
"ruby"

Class Method Summary collapse

Class Method Details

.a2dismod(options = {}) ⇒ Object

The absolute path to the ‘a2enmod’ executable.



300
301
302
303
304
305
306
307
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 300

def self.a2dismod(options = {})
	apxs2 = options[:apxs2] || self.apxs2
	if env_defined?('A2DISMOD')
		return ENV['A2DISMOD']
	else
		return find_apache2_executable("a2dismod", options)
	end
end

.a2enmod(options = {}) ⇒ Object

The absolute path to the ‘a2enmod’ executable.



289
290
291
292
293
294
295
296
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 289

def self.a2enmod(options = {})
	apxs2 = options[:apxs2] || self.apxs2
	if env_defined?('A2ENMOD')
		return ENV['A2ENMOD']
	else
		return find_apache2_executable("a2enmod", options)
	end
end

.adress_sanitizer_flag ⇒ Object 



417
418
419
420
421
422
423
424
425
426
427
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 417

def self.adress_sanitizer_flag
	if cc_is_clang?
		if `#{cc} --help` =~ /-fsanitize=/
			return "-fsanitize=address"
		else
			return "-faddress-sanitizer"
		end
	else
		return nil
	end
end

.apache2_bindir(options = {}) ⇒ Object

The absolute path to the Apache 2 ‘bin’ directory, or nil if unknown.



401
402
403
404
405
406
407
408
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 401

def self.apache2_bindir(options = {})
	apxs2 = options[:apxs2] || self.apxs2
	if apxs2.nil?
		return nil
	else
		return `#{apxs2} -q BINDIR 2>/dev/null`.strip
	end
end

.apache2_module_cflags(with_apr_flags = true) ⇒ Object

The C compiler flags that are necessary to compile an Apache module. Also includes APR and APU compiler flags if with_apr_flags is true.



427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 427

def self.apache2_module_cflags(with_apr_flags = true)
	flags = [""]
	if cc_is_sun_studio?
		flags << "-KPIC"
	else
		flags << "-fPIC"
	end
	if with_apr_flags
		flags << apr_flags
		flags << apu_flags
	end
	if !apxs2.nil?
		apxs2_flags = `#{apxs2} -q CFLAGS`.strip << " -I" << `#{apxs2} -q INCLUDEDIR`.strip
		apxs2_flags.gsub!(/-O\d? /, '')

		# Remove flags not supported by GCC
		if os_name =~ /solaris/ # TODO: Add support for people using SunStudio
			# The big problem is Coolstack apxs includes a bunch of solaris -x directives.
			options = apxs2_flags.split
			options.reject! { |f| f =~ /^\-x/ }
			options.reject! { |f| f =~ /^\-Xa/ }
			options.reject! { |f| f =~ /^\-fast/ }
			options.reject! { |f| f =~ /^\-mt/ }
			apxs2_flags = options.join(' ')
		end

		if os_name == "linux" &&
		   linux_distro_tags.include?(:redhat) &&
		   apxs2 == "/usr/sbin/apxs" &&
		   httpd_architecture_bits == 64
			# The Apache package in CentOS 5 x86_64 is broken.
			# 'apxs -q CFLAGS' contains directives for compiling
			# the module as 32-bit, even though httpd itself
			# is 64-bit. Fix this.
			apxs2_flags.gsub!('-m32 -march=i386 -mtune=generic', '')
		end
		
		apxs2_flags.strip!
		flags << apxs2_flags
	end
	if !httpd.nil? && os_name == "macosx"
		# The default Apache install on OS X is a universal binary.
		# Figure out which architectures it's compiled for and do the same
		# thing for mod_passenger. We use the 'file' utility to do this.
		#
		# Running 'file' on the Apache executable usually outputs something
		# like this:
		#
		#   /usr/sbin/httpd: Mach-O universal binary with 4 architectures
		#   /usr/sbin/httpd (for architecture ppc7400):     Mach-O executable ppc
		#   /usr/sbin/httpd (for architecture ppc64):       Mach-O 64-bit executable ppc64
		#   /usr/sbin/httpd (for architecture i386):        Mach-O executable i386
		#   /usr/sbin/httpd (for architecture x86_64):      Mach-O 64-bit executable x86_64
		#
		# But on some machines, it may output just:
		#
		#   /usr/sbin/httpd: Mach-O fat file with 4 architectures
		#
		# (http://code.google.com/p/phusion-passenger/issues/detail?id=236)
		output = `file "#{httpd}"`.strip
		if output =~ /Mach-O fat file/ && output !~ /for architecture/
			architectures = ["i386", "ppc", "x86_64", "ppc64"]
		else
			architectures = []
			output.split("\n").grep(/for architecture/).each do |line|
				line =~ /for architecture (.*?)\)/
				architectures << $1
			end
		end
		# The compiler may not support all architectures in the binary.
		# XCode 4 seems to have removed support for the PPC architecture
		# even though there are still plenty of Apache binaries around
		# containing PPC components.
		architectures.reject! do |arch|
			!compiler_supports_architecture?(arch)
		end
		architectures.map! do |arch|
			"-arch #{arch}"
		end
		flags << architectures.compact.join(' ')
	end
	return flags.compact.join(' ').strip
end

.apache2_module_ldflags ⇒ Object

Linker flags that are necessary for linking an Apache module. Already includes APR and APU linker flags.



514
515
516
517
518
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 514

def self.apache2_module_ldflags
	flags = "-fPIC #{apr_libs} #{apu_libs}"
	flags.strip!
	return flags
end

.apache2_sbindir(options = {}) ⇒ Object

The absolute path to the Apache 2 ‘sbin’ directory, or nil if unknown.



412
413
414
415
416
417
418
419
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 412

def self.apache2_sbindir(options = {})
	apxs2 = options[:apxs2] || self.apxs2
	if apxs2.nil?
		return nil
	else
		return `#{apxs2} -q SBINDIR`.strip
	end
end

.apache2ctl(options = {}) ⇒ Object

The absolute path to the ‘apachectl’ or ‘apache2ctl’ binary, or nil if not found.



62
63
64
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 62

def self.apache2ctl(options = {})
	return find_apache2_executable('apache2ctl', 'apachectl2', 'apachectl', options)
end

.apr_config ⇒ Object

The absolute path to the ‘apr-config’ or ‘apr-1-config’ executable, or nil if not found.



312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 312

def self.apr_config
	if env_defined?('APR_CONFIG')
		return ENV['APR_CONFIG']
	elsif apxs2.nil?
		return nil
	else
		filename = `#{apxs2} -q APR_CONFIG 2>/dev/null`.strip
		if filename.empty?
			apr_bindir = `#{apxs2} -q APR_BINDIR 2>/dev/null`.strip
			if apr_bindir.empty?
				return nil
			else
				return select_executable(apr_bindir,
					"apr-1-config", "apr-config")
			end
		elsif File.exist?(filename)
			return filename
		else
			return nil
		end
	end
end

.apr_config_needed_for_building_apache_modules? ⇒ Boolean

Returns whether it is necessary to use information outputted by ‘apr-config’ and ‘apu-config’ in order to compile an Apache module. When Apache is installed with –with-included-apr, the APR/APU headers are placed into the same directory as the Apache headers, and so ‘apr-config’ and ‘apu-config’ won’t be necessary in that case.

Returns:

  • (Boolean) 


549
550
551
552
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 549

def self.apr_config_needed_for_building_apache_modules?
	return !try_compile("whether APR is needed for building Apache modules",
		:c, "#include <apr.h>\n", apache2_module_cflags(false))
end

.apr_flags ⇒ Object

The C compiler flags that are necessary for programs that use APR.



522
523
524
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 522

def self.apr_flags
	return determine_apr_info[0]
end

.apr_libs ⇒ Object

The linker flags that are necessary for linking programs that use APR.



527
528
529
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 527

def self.apr_libs
	return determine_apr_info[1]
end

.apu_config ⇒ Object

The absolute path to the ‘apu-config’ or ‘apu-1-config’ executable, or nil if not found.



338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 338

def self.apu_config
	if env_defined?('APU_CONFIG')
		return ENV['APU_CONFIG']
	elsif apxs2.nil?
		return nil
	else
		filename = `#{apxs2} -q APU_CONFIG 2>/dev/null`.strip
		if filename.empty?
			apu_bindir = `#{apxs2} -q APU_BINDIR 2>/dev/null`.strip
			if apu_bindir.empty?
				return nil
			else
				return select_executable(apu_bindir,
					"apu-1-config", "apu-config")
			end
		elsif File.exist?(filename)
			return filename
		else
			return nil
		end
	end
end

.apu_flags ⇒ Object

The C compiler flags that are necessary for programs that use APR-Util.



532
533
534
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 532

def self.apu_flags
	return determine_apu_info[0]
end

.apu_libs ⇒ Object

The linker flags that are necessary for linking programs that use APR-Util.



537
538
539
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 537

def self.apu_libs
	return determine_apu_info[1]
end

.apxs2 ⇒ Object

The absolute path to the ‘apxs’ or ‘apxs2’ executable, or nil if not found.



46
47
48
49
50
51
52
53
54
55
56
57
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 46

def self.apxs2
	if env_defined?("APXS2")
		return ENV["APXS2"]
	end
	['apxs2', 'apxs'].each do |name|
		command = find_command(name)
		if !command.nil?
			return command
		end
	end
	return nil
end

.cache_dir ⇒ Object 



186
187
188
 
# File 'lib/phusion_passenger/platform_info.rb', line 186

def self.cache_dir
	return @@cache_dir
end

.cache_dir=(value) ⇒ Object 



182
183
184
 
# File 'lib/phusion_passenger/platform_info.rb', line 182

def self.cache_dir=(value)
	@@cache_dir = value
end

.cc ⇒ Object 



144
145
146
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 144

def self.cc
	return string_env('CC', default_cc)
end

.cc_is_clang? ⇒ Boolean

Returns:

  • (Boolean) 


178
179
180
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 178

def self.cc_is_clang?
	`#{cc} --version 2>&1` =~ /clang version/
end

.cc_is_gcc? ⇒ Boolean

Returns:

  • (Boolean) 


173
174
175
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 173

def self.cc_is_gcc?
	`#{cc} -v 2>&1` =~ /gcc version/
end

.cc_is_sun_studio? ⇒ Boolean

Returns:

  • (Boolean) 


188
189
190
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 188

def self.cc_is_sun_studio?
	`#{cc} -V 2>&1` =~ /Sun C/ || `#{cc} -flags 2>&1` =~ /Sun C/
end

.cc_supports_feliminate_unused_debug? ⇒ Boolean

Returns:

  • (Boolean) 


383
384
385
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 383

def self.cc_supports_feliminate_unused_debug?
	return cc_or_cxx_supports_feliminate_unused_debug?(:c)
end

.cc_supports_no_tls_direct_seg_refs_option? ⇒ Boolean

Returns:

  • (Boolean) 


340
341
342
343
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 340

def self.cc_supports_no_tls_direct_seg_refs_option?
	return try_compile("Checking for C compiler '-mno-tls-direct-seg-refs' support",
		:c, '', '-mno-tls-direct-seg-refs')
end

.cc_supports_visibility_flag? ⇒ Boolean

Returns:

  • (Boolean) 


302
303
304
305
306
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 302

def self.cc_supports_visibility_flag?
	return false if os_name =~ /aix/
	return try_compile("Checking for C compiler '-fvisibility' support",
		:c, '', '-fvisibility=hidden')
end

.cc_supports_wno_attributes_flag? ⇒ Boolean

Returns:

  • (Boolean) 


316
317
318
319
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 316

def self.cc_supports_wno_attributes_flag?
	return try_compile("Checking for C compiler '-Wno-attributes' support",
		:c, '', '-Wno-attributes')
end

.cc_supports_wno_missing_field_initializers_flag? ⇒ Boolean

Returns:

  • (Boolean) 


328
329
330
331
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 328

def self.cc_supports_wno_missing_field_initializers_flag?
	return try_compile("Checking for C compiler '-Wno-missing-field-initializers' support",
		:c, '', '-Wno-missing-field-initializers')
end

.cc_visibility_flag_generates_warnings? ⇒ Boolean

Returns whether compiling C++ with -fvisibility=hidden might result in tons of useless warnings, like this: code.google.com/p/phusion-passenger/issues/detail?id=526 This appears to be a bug in older g++ versions: gcc.gnu.org/ml/gcc-patches/2006-07/msg00861.html Warnings should be suppressed with -Wno-attributes.

Returns:

  • (Boolean) 


399
400
401
402
403
404
405
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 399

def self.cc_visibility_flag_generates_warnings?
	if os_name =~ /linux/ && `#{cc} -v 2>&1` =~ /gcc version (.*?)/
		return $1 <= "4.1.2"
	else
		return false
	end
end

.compiler_supports_architecture?(arch) ⇒ Boolean

Checks whether the compiler supports “-arch #arch”.

Returns:

  • (Boolean) 


297
298
299
300
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 297

def self.compiler_supports_architecture?(arch)
	return try_compile("Checking for C compiler '-arch' support",
		:c, '', "-arch #{arch}")
end

.compiler_supports_wno_ambiguous_member_template? ⇒ Boolean

Returns:

  • (Boolean) 


352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 352

def self.compiler_supports_wno_ambiguous_member_template?
	result = try_compile("Checking for C++ compiler '-Wno-ambiguous-member-template' support",
		:cxx, '', '-Wno-ambiguous-member-template')
	return false if !result

	# For some reason, GCC does not complain about -Wno-ambiguous-member-template
	# not being supported unless the source contains another error. So we
	# check for this.
	create_temp_file("passenger-compile-check.cpp") do |filename, f|
		source = %Q{
			void foo() {
				return error;
			}
		}
		f.puts(source)
		f.close
		begin
			command = create_compiler_command(:cxx,
				"-c '#{filename}' -o '#{filename}.o'",
				'-Wno-ambiguous-member-template')
			result = run_compiler("Checking whether C++ compiler '-Wno-ambiguous-member-template' support is *really* supported",
				command, filename, source, :always)
		ensure
			File.unlink("#{filename}.o") rescue nil
		end
	end

	return result && result[:output] !~ /-Wno-ambiguous-member-template/
end

.cpu_architectures ⇒ Object

Returns a list of all CPU architecture names that the current machine CPU supports. If there are multiple such architectures then the first item in the result denotes that OS runtime’s main/preferred architecture.

This function normalizes some names. For example x86 is always reported as “x86” regardless of whether the OS reports it as “i386” or “i686”. x86_64 is always reported as “x86_64” even if the OS reports it as “amd64”.

Please note that even if the CPU supports multiple architectures, the operating system might not. For example most x86 CPUs nowadays also support x86_64, but x86_64 Linux systems require various x86 compatibility libraries to be installed before x86 executables can be run. This function does not detect whether these compatibility libraries are installed. The only guarantee that you have is that the OS can run executables in the architecture denoted by the first item in the result.

For example, on x86_64 Linux this function can return [“x86_64”, “x86”]. This indicates that the CPU supports both of these architectures, and that the OS’s main/preferred architecture is x86_64. Most executables on the system are thus be x86_64. It is guaranteed that the OS can run x86_64 executables, but not x86 executables per se.

Another example: on MacOS X this function can return either

“x86_64”, “x86”

or [“x86”, “x86_64”]. The former result indicates

OS X 10.6 (Snow Leopard) and beyond because starting from that version everything is 64-bit by default. The latter result indicates an OS X version older than 10.6.



79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
 
# File 'lib/phusion_passenger/platform_info/operating_system.rb', line 79

def self.cpu_architectures
	if os_name == "macosx"
		arch = `uname -p`.strip
		if arch == "i386"
			# Macs have been x86 since around 2007. I think all of them come with
			# a recent enough Intel CPU that supports both x86 and x86_64, and I
			# think every OS X version has both the x86 and x86_64 runtime installed.
			major, minor, *rest = `sw_vers -productVersion`.strip.split(".")
			major = major.to_i
			minor = minor.to_i
			if major >= 10 || (major == 10 && minor >= 6)
				# Since Snow Leopard x86_64 is the default.
				["x86_64", "x86"]
			else
				# Before Snow Leopard x86 was the default.
				["x86", "x86_64"]
			end
		else
			arch
		end
	else
		arch = `uname -p`.strip
		# On some systems 'uname -p' returns something like
		# 'Intel(R) Pentium(R) M processor 1400MHz' or
		# 'Intel(R)_Xeon(R)_CPU___________X7460__@_2.66GHz'.
		if arch == "unknown" || arch =~ / / || arch =~ /Hz$/
			arch = `uname -m`.strip
		end
		if arch =~ /^i.86$/
			arch = "x86"
		elsif arch == "amd64"
			arch = "x86_64"
		end
		
		if arch == "x86"
			# Most x86 operating systems nowadays are probably running on
			# a CPU that supports both x86 and x86_64, but we're not gonna
			# go through the trouble of checking that. The main architecture
			# is what we usually care about.
			["x86"]
		elsif arch == "x86_64"
			# I don't think there's a single x86_64 CPU out there
			# that doesn't support x86 as well.
			["x86_64", "x86"]
		else
			[arch]
		end
	end
end

.curl_flags ⇒ Object 



29
30
31
32
33
34
35
36
37
38
39
40
41
 
# File 'lib/phusion_passenger/platform_info/curl.rb', line 29

def self.curl_flags
	result = `(curl-config --cflags) 2>/dev/null`.strip
	if result.empty?
		return nil
	else
		version = `curl-config --vernum`.strip
		if version >= '070c01'
			# Curl >= 7.12.1 supports curl_easy_reset()
			result << " -DHAS_CURL_EASY_RESET"
		end
		return result
	end
end

.curl_libs ⇒ Object 



44
45
46
47
48
49
50
51
 
# File 'lib/phusion_passenger/platform_info/curl.rb', line 44

def self.curl_libs
	result = `(curl-config --libs) 2>/dev/null`.strip
	if result.empty?
		return nil
	else
		return result
	end
end

.curl_supports_ssl? ⇒ Boolean

Returns:

  • (Boolean) 


54
55
56
57
 
# File 'lib/phusion_passenger/platform_info/curl.rb', line 54

def self.curl_supports_ssl?
	features = `(curl-config --feature) 2>/dev/null`
	return features =~ /SSL/
end

.cxx ⇒ Object 



148
149
150
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 148

def self.cxx
	return string_env('CXX', default_cxx)
end

.cxx_binary_compatibility_id ⇒ Object

Returns an identifier string that describes the current platform’s binary compatibility with regard to C/C++ binaries. Two systems with the same binary compatibility identifiers should be able to run the same C/C++ binaries.

The the string depends on the following factors:

  • The operating system name.

  • Operating system runtime identifier. This may include the kernel version, libc version, C++ ABI version, etc. Everything that is of interest for binary compatibility with regard to C/C++ binaries.

  • Operating system default runtime architecture. This is not the same as the CPU architecture; some CPUs support multiple architectures, e.g. Intel Core 2 Duo supports x86 and x86_64. Some operating systems actually support multiple runtime architectures: a lot of x86_64 Linux distributions also include 32-bit runtimes, and OS X Snow Leopard is x86_64 by default but all system libraries also support x86. This component identifies the architecture that is used when compiling a binary with the system’s C++ compiler with its default options.



110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
 
# File 'lib/phusion_passenger/platform_info/binary_compatibility.rb', line 110

def self.cxx_binary_compatibility_id
	if os_name == "macosx"
		# RUBY_PLATFORM gives us the kernel version, but we want
		# the OS X version.
		os_version_string = `sw_vers -productVersion`.strip
		# sw_vers returns something like "10.6.2". We're only
		# interested in the first two digits (MAJOR.MINOR) since
		# tiny releases tend to be binary compatible with each
		# other.
		components = os_version_string.split(".")
		os_version = "#{components[0]}.#{components[1]}"
		os_runtime = os_version
		
		os_arch = cpu_architectures[0]
		if os_version >= "10.5" && os_arch =~ /^i.86$/
			# On Snow Leopard, 'uname -m' returns i386 but
			# we *know* that everything is x86_64 by default.
			os_arch = "x86_64"
		end
	else
		os_arch = cpu_architectures[0]
		os_runtime = nil
	end
	
	return [os_arch, os_name, os_runtime].compact.join("-")
end

.cxx_is_clang? ⇒ Boolean

Returns:

  • (Boolean) 


183
184
185
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 183

def self.cxx_is_clang?
	`#{cxx} --version 2>&1` =~ /clang version/
end

.cxx_is_sun_studio? ⇒ Boolean

Returns:

  • (Boolean) 


193
194
195
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 193

def self.cxx_is_sun_studio?
	`#{cxx} -V 2>&1` =~ /Sun C/ || `#{cc} -flags 2>&1` =~ /Sun C/
end

.cxx_supports_feliminate_unused_debug? ⇒ Boolean

Returns:

  • (Boolean) 


388
389
390
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 388

def self.cxx_supports_feliminate_unused_debug?
	return cc_or_cxx_supports_feliminate_unused_debug?(:cxx)
end

.cxx_supports_no_tls_direct_seg_refs_option? ⇒ Boolean

Returns:

  • (Boolean) 


346
347
348
349
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 346

def self.cxx_supports_no_tls_direct_seg_refs_option?
	return try_compile("Checking for C++ compiler '-mno-tls-direct-seg-refs' support",
		:cxx, '', '-mno-tls-direct-seg-refs')
end

.cxx_supports_visibility_flag? ⇒ Boolean

Returns:

  • (Boolean) 


309
310
311
312
313
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 309

def self.cxx_supports_visibility_flag?
	return false if os_name =~ /aix/
	return try_compile("Checking for C++ compiler '-fvisibility' support",
		:cxx, '', '-fvisibility=hidden')
end

.cxx_supports_wno_attributes_flag? ⇒ Boolean

Returns:

  • (Boolean) 


322
323
324
325
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 322

def self.cxx_supports_wno_attributes_flag?
	return try_compile("Checking for C++ compiler '-Wno-attributes' support",
		:cxx, '', '-Wno-attributes')
end

.cxx_supports_wno_missing_field_initializers_flag? ⇒ Boolean

Returns:

  • (Boolean) 


334
335
336
337
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 334

def self.cxx_supports_wno_missing_field_initializers_flag?
	return try_compile("Checking for C++ compiler '-Wno-missing-field-initializers' support",
		:cxx, '', '-Wno-missing-field-initializers')
end

.cxx_visibility_flag_generates_warnings? ⇒ Boolean

Returns:

  • (Boolean) 


408
409
410
411
412
413
414
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 408

def self.cxx_visibility_flag_generates_warnings?
	if os_name =~ /linux/ && `#{cxx} -v 2>&1` =~ /gcc version (.*?)/
		return $1 <= "4.1.2"
	else
		return false
	end
end

.debugging_cflags ⇒ Object

C compiler flags that should be passed in order to enable debugging information.



458
459
460
461
462
463
464
465
466
467
468
469
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 458

def self.debugging_cflags
	# According to OpenBSD's pthreads man page, pthreads do not work
	# correctly when an app is compiled with -g. It recommends using
	# -ggdb instead.
	#
	# In any case we'll always want to use -ggdb for better GDB debugging.
	if cc_is_gcc?
		return '-ggdb'
	else
		return '-g'
	end
end

.default_cc ⇒ Object 



152
153
154
155
156
157
158
159
160
161
162
163
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 152

def self.default_cc
	# OS X Mavericks (10.9) switched from GCC to Clang as the default compiler,
	# i.e. as an alias for 'cc'. Since the Nginx by default uses 'cc' as the compiler,
	# we'll have to do that too. Otherwise we'll get C++ linker errors because Nginx
	# is compiled with Clang while Phusion Passenger is compiled with GCC.
	# https://code.google.com/p/phusion-passenger/issues/detail?id=950
	if PlatformInfo.os_name == "macosx"
		return 'cc'
	else
		return 'gcc'
	end
end

.default_cxx ⇒ Object 



165
166
167
168
169
170
171
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 165

def self.default_cxx
	if PlatformInfo.os_name == "macosx"
		return 'c++'
	else
		return 'g++'
	end
end

.default_extra_cflags ⇒ Object

Extra compiler flags that should always be passed to the C compiler, last in the command string.



48
49
50
 
# File 'lib/phusion_passenger/platform_info/cxx_portability.rb', line 48

def self.default_extra_cflags
	return default_extra_c_or_cxxflags(:cc)
end

.default_extra_cxxflags ⇒ Object

Extra compiler flags that should always be passed to the C++ compiler, last in the command string.



55
56
57
 
# File 'lib/phusion_passenger/platform_info/cxx_portability.rb', line 55

def self.default_extra_cxxflags
	return default_extra_c_or_cxxflags(:cxx)
end

.dmalloc_ldflags ⇒ Object 



471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 471

def self.dmalloc_ldflags
	if !ENV['DMALLOC_LIBS'].to_s.empty?
		return ENV['DMALLOC_LIBS']
	end
	if os_name == "macosx"
		['/opt/local', '/usr/local', '/usr'].each do |prefix|
			filename = "#{prefix}/lib/libdmallocthcxx.a"
			if File.exist?(filename)
				return filename
			end
		end
		return nil
	else
		return "-ldmallocthcxx"
	end
end

.electric_fence_ldflags ⇒ Object 



489
490
491
492
493
494
495
496
497
498
499
500
501
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 489

def self.electric_fence_ldflags
	if os_name == "macosx"
		['/opt/local', '/usr/local', '/usr'].each do |prefix|
			filename = "#{prefix}/lib/libefence.a"
			if File.exist?(filename)
				return filename
			end
		end
		return nil
	else
		return "-lefence"
	end
end

.env_defined?(name) ⇒ Boolean

Returns:

  • (Boolean) 


207
208
209
 
# File 'lib/phusion_passenger/platform_info.rb', line 207

def self.env_defined?(name)
	return !ENV[name].nil? && !ENV[name].empty?
end

.export_dynamic_flags ⇒ Object 



504
505
506
507
508
509
510
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 504

def self.export_dynamic_flags
	if os_name == "linux"
		return '-rdynamic'
	else
		return nil
	end
end

.find_all_commands(name) ⇒ Object 



360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
 
# File 'lib/phusion_passenger/platform_info.rb', line 360

def self.find_all_commands(name)
	search_dirs = ENV['PATH'].to_s.split(File::PATH_SEPARATOR)
	search_dirs.concat(%w(/bin /sbin /usr/bin /usr/sbin /usr/local/bin /usr/local/sbin))
	["/opt/*/bin", "/opt/*/sbin", "/usr/local/*/bin", "/usr/local/*/sbin"].each do |glob|
		search_dirs.concat(Dir[glob])
	end
	search_dirs.delete("")
	search_dirs.uniq!

	result = []
	search_dirs.each do |directory|
		path = File.join(directory, name)
		if !File.exist?(path)
			log "Looking for #{path}: not found"
		elsif !File.file?(path)
			log "Looking for #{path}: found, but is not a file"
		elsif !File.executable?(path)
			log "Looking for #{path}: found, but is not executable"
		else
			log "Looking for #{path}: found"
			result << path
		end
	end
	return result
end

.find_apache2_executable(*possible_names) ⇒ Object

Find an executable in the Apache ‘bin’ and ‘sbin’ directories. Returns nil if not found.



364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 364

def self.find_apache2_executable(*possible_names)
	if possible_names.last.is_a?(Hash)
		options = possible_names.pop
		options = nil if options.empty?
	end

	if options
		dirs = options[:dirs] || [apache2_bindir(options), apache2_sbindir(options)]
	else
		dirs = [apache2_bindir, apache2_sbindir]
	end

	dirs.each do |bindir|
		if bindir.nil?
			next
		end
		possible_names.each do |name|
			filename = "#{bindir}/#{name}"
			if !File.exist?(filename)
				log "Looking for #{filename}: not found"
			elsif !File.file?(filename)
				log "Looking for #{filename}: found, but is not a file"
			elsif !File.executable?(filename)
				log "Looking for #{filename}: found, but is not executable"
			else
				log "Looking for #{filename}: found"
				return filename
			end
		end
	end
	return nil
end

.find_command(name, is_executable = true) ⇒ Object

Check whether the specified command is in $PATH, and return its absolute filename. Returns nil if the command is not found.

This function exists because system(‘which’) doesn’t always behave correctly, for some weird reason.

When ‘is_executable` is true, this function checks whether there is an executable named `name` in $PATH. When false, it assumes that `name` is not an executable name but a command string (e.g. “ccache gcc”). It then infers the executable name (“ccache”) from the command string, and checks for that instead.



337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
 
# File 'lib/phusion_passenger/platform_info.rb', line 337

def self.find_command(name, is_executable = true)
	name = name.to_s
	if !is_executable && name =~ / /
		name = name.sub(/ .*/, '')
	end
	if name =~ /^\//
		if File.executable?(name)
			return name
		else
			return nil
		end
	else
		ENV['PATH'].to_s.split(File::PATH_SEPARATOR).each do |directory|
			next if directory.empty?
			path = File.join(directory, name)
			if File.file?(path) && File.executable?(path)
				return path
			end
		end
		return nil
	end
end

.find_header(header_name, language, flags = nil) ⇒ Object

Looks for the given C or C++ header. This works by invoking the compiler and searching in the compiler’s header search path. Returns its full filename, or true if this function knows that the header exists but can’t find it (e.g. because the compiler cannot tell us what its header search path is). Returns nil if the header cannot be found.



204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 204

def self.find_header(header_name, language, flags = nil)
	extension = detect_language_extension(language)
	create_temp_file("passenger-compile-check.#{extension}") do |filename, f|
		source = %Q{
			#include <#{header_name}>
		}
		f.puts(source)
		f.close
		begin
			command = create_compiler_command(language,
				"-v -c '#{filename}' -o '#{filename}.o'",
				flags)
			if result = run_compiler("Checking for #{header_name}", command, filename, source, true)
				result[:output] =~ /^#include <...> search starts here:$(.+?)^End of search list\.$/m
				search_paths = $1.to_s.strip.split("\n").map{ |line| line.strip }
				search_paths.each do |dir|
					if File.file?("#{dir}/#{header_name}")
						return "#{dir}/#{header_name}"
					end
				end
				return true
			else
				return nil
			end
		ensure
			File.unlink("#{filename}.o") rescue nil
		end
	end
end

.gem_command(options = {}) ⇒ Object

Returns the correct ‘gem’ command for this Ruby interpreter. If ‘:sudo => true` is given, then the gem command is prefixed by a sudo command if filesystem permissions require this.



146
147
148
149
150
151
152
 
# File 'lib/phusion_passenger/platform_info/ruby.rb', line 146

def self.gem_command(options = {})
	command = locate_ruby_tool('gem')
	if options[:sudo] && gem_install_requires_sudo?
		command = "#{ruby_sudo_command} #{command}"
	end
	return command
end

.gem_install_requires_sudo? ⇒ Boolean

Returns whether running ‘gem install’ as the current user requires sudo.

Returns:

  • (Boolean) 


156
157
158
159
160
 
# File 'lib/phusion_passenger/platform_info/ruby.rb', line 156

def self.gem_install_requires_sudo?
	`#{gem_command} env` =~ /INSTALLATION DIRECTORY: (.+)/
	install_dir = $1
	return !File.writable?(install_dir)
end

.gnu_make ⇒ Object 



518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 518

def self.gnu_make
	if result = string_env('GMAKE')
		return result
	else
		result = find_command('gmake')
		if !result
			result = find_command('make')
			if result
				if `#{result} --version 2>&1` =~ /GNU/
					return result
				else
					return nil
				end
			else
				return nil
			end
		else
			return result
		end
	end
end

.has_accept4? ⇒ Boolean

Returns:

  • (Boolean) 


448
449
450
451
452
453
454
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 448

def self.has_accept4?
	return try_compile("Checking for accept4()", :c, %Q{
		#define _GNU_SOURCE
		#include <sys/socket.h>
		static void *foo = accept4;
	})
end

.has_alloca_h? ⇒ Boolean

Returns:

  • (Boolean) 


442
443
444
445
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 442

def self.has_alloca_h?
	return try_compile("Checking for alloca.h",
		:c, '#include <alloca.h>')
end

.has_math_library? ⇒ Boolean

Returns:

  • (Boolean) 


436
437
438
439
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 436

def self.has_math_library?
	return try_link("Checking for -lmath support",
		:c, "int main() { return 0; }\n", '-lmath')
end

.has_rt_library? ⇒ Boolean

Returns:

  • (Boolean) 


430
431
432
433
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 430

def self.has_rt_library?
	return try_link("Checking for -lrt support",
		:c, "int main() { return 0; }\n", '-lrt')
end

.httpd(options = {}) ⇒ Object

The absolute path to the Apache binary (that is, ‘httpd’, ‘httpd2’, ‘apache’ or ‘apache2’), or nil if not found.



69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 69

def self.httpd(options = {})
	apxs2 = options[:apxs2] || self.apxs2
	if env_defined?('HTTPD')
		return ENV['HTTPD']
	elsif apxs2.nil?
		["apache2", "httpd2", "apache", "httpd"].each do |name|
			command = find_command(name)
			if !command.nil?
				return command
			end
		end
		return nil
	else
		return find_apache2_executable(`#{apxs2} -q TARGET`.strip, options)
	end
end

.httpd_actual_error_log(options = nil) ⇒ Object 



185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 185

def self.httpd_actual_error_log(options = nil)
	if config_file = httpd_default_config_file(options)
		contents = File.read(config_file)
		# We don't want to match comments
		contents.gsub!(/^[ \t]*#.*/, '')
		if contents =~ /^ErrorLog (.+)$/
			filename = $1.strip.sub(/^"/, '').sub(/"$/, '')
			if filename.include?("${")
				log "Error log seems to be located in \"#{filename}\", " +
					"but value contains environment variables. " +
					"Attempting to substitute them..."
			end
			# The Apache config file supports environment variable
			# substitution. Ubuntu uses this extensively.
			filename.gsub!(/\$\{(.+?)\}/) do |varname|
				if value = httpd_infer_envvar($1, options)
					log "Substituted \"#{varname}\" -> \"#{value}\""
					value
				else
					log "Cannot substituted \"#{varname}\""
					varname
				end
			end
			if filename.include?("${")
				# We couldn't substitute everything.
				return nil
			end
			if filename !~ /\A\//
				# Not an absolute path. Infer from root.
				if root = httpd_root(options)
					return "#{root}/#{filename}"
				else
					return nil
				end
			else
				return filename
			end
		elsif contents =~ /ErrorLog/
			# The user apparently has ErrorLog set somewhere but
			# we can't parse it. The default error log location,
			# as reported by `httpd -V`, may be wrong (it is on OS X).
			# So to be safe, let's assume that we don't know.
			return nil
		else
			return httpd_default_error_log(options)
		end
	else
		return nil
	end
end

.httpd_architecture_bits(options = nil) ⇒ Object

The Apache executable’s architectural bits. Returns 32 or 64, or nil if unable to detect.



105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 105

def self.httpd_architecture_bits(options = nil)
	if options
		httpd = options[:httpd] || self.httpd(options)
	else
		httpd = self.httpd
	end
	if httpd
		`#{httpd} -V` =~ %r{Architecture:(.*)}
		text = $1
		if text =~ /32/
			return 32
		elsif text =~ /64/
			return 64
		else
			return nil
		end
	else
		return nil
	end
end

.httpd_default_config_file(options = nil) ⇒ Object

The default Apache configuration file, or nil if Apache is not found.



139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 139

def self.httpd_default_config_file(options = nil)
	if info = httpd_V(options)
		info =~ /-D SERVER_CONFIG_FILE="(.+)"$/
		filename = $1
		if filename =~ /\A\//
			return filename
		else
			# Not an absolute path. Infer from root.
			if root = httpd_root(options)
				return "#{root}/#{filename}"
			else
				return nil
			end
		end
	else
		return nil
	end
end

.httpd_default_error_log(options = nil) ⇒ Object

The default Apache error log’s filename, as it is compiled into the Apache main executable. This may not be the actual error log that is used. The actual error log depends on the configuration file.

Returns nil if Apache is not detected, or if the default error log filename cannot be detected.



165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 165

def self.httpd_default_error_log(options = nil)
	if info = httpd_V(options)
		info =~ /-D DEFAULT_ERRORLOG="(.+)"$/
		filename = $1
		if filename =~ /\A\//
			return filename
		else
			# Not an absolute path. Infer from root.
			if root = httpd_root(options)
				return "#{root}/#{filename}"
			else
				return nil
			end
		end
	else
		return nil
	end
end

.httpd_envvars_file(options = nil) ⇒ Object

The location of the Apache envvars file, which exists on some systems such as Ubuntu. Returns nil if Apache is not found or if the envvars file is not found.



239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 239

def self.httpd_envvars_file(options = nil)
	if options
		httpd = options[:httpd] || self.httpd(options)
	else
		httpd = self.httpd
	end
	
	httpd_dir = File.dirname(httpd)
	if httpd_dir == "/usr/bin" || httpd_dir == "/usr/sbin"
		if File.exist?("/etc/apache2/envvars")
			return "/etc/apache2/envvars"
		elsif File.exist?("/etc/httpd/envvars")
			return "/etc/httpd/envvars"
		end
	end
	
	conf_dir = File.expand_path(File.dirname(httpd) + "/../conf")
	if File.exist?("#{conf_dir}/envvars")
		return "#{conf_dir}/envvars"
	end

	return nil
end

.httpd_infer_envvar(varname, options = nil) ⇒ Object 



263
264
265
266
267
268
269
270
271
272
273
274
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 263

def self.httpd_infer_envvar(varname, options = nil)
	if envfile = httpd_envvars_file(options)
		result = `. '#{envfile}' && echo $#{varname}`.strip
		if $? && $?.exitstatus == 0
			return result
		else
			return nil
		end
	else
		return nil
	end
end

.httpd_root(options = nil) ⇒ Object

The Apache root directory.



128
129
130
131
132
133
134
135
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 128

def self.httpd_root(options = nil)
	if info = httpd_V(options)
		info =~ / -D HTTPD_ROOT="(.+)"$/
		return $1
	else
		return nil
	end
end

.httpd_supports_a2enmod?(options = nil) ⇒ Boolean

Whether Apache appears to support a2enmod and a2dismod.

Returns:

  • (Boolean) 


277
278
279
280
281
282
283
284
285
286
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 277

def self.httpd_supports_a2enmod?(options = nil)
	config_file = httpd_default_config_file(options)
	if config_file
		config_dir = File.dirname(config_file)
		return File.exist?("#{config_dir}/mods-available") &&
			File.exist?("#{config_dir}/mods-enabled")
	else
		return nil
	end
end

.httpd_version(options = nil) ⇒ Object

The Apache version, or nil if Apache is not found.



88
89
90
91
92
93
94
95
96
97
98
99
100
 
# File 'lib/phusion_passenger/platform_info/apache.rb', line 88

def self.httpd_version(options = nil)
	if options
		httpd = options[:httpd] || self.httpd(options)
	else
		httpd = self.httpd
	end
	if httpd
		`#{httpd} -v` =~ %r{Apache/([\d\.]+)}
		return $1
	else
		return nil
	end
end

.in_rvm? ⇒ Boolean

Returns whether the current Ruby interpreter is managed by RVM.

Returns:

  • (Boolean) 


202
203
204
205
 
# File 'lib/phusion_passenger/platform_info/ruby.rb', line 202

def self.in_rvm?
	bindir = rb_config['bindir']
	return bindir.include?('/.rvm/') || bindir.include?('/rvm/')
end

.library_extension ⇒ Object

The current platform’s shared library extension (‘so’ on most Unices).



44
45
46
47
48
49
50
 
# File 'lib/phusion_passenger/platform_info/operating_system.rb', line 44

def self.library_extension
	if os_name == "macosx"
		return "bundle"
	else
		return "so"
	end
end

.linux_distro ⇒ Object

An identifier for the current Linux distribution. nil if the operating system is not Linux.



31
32
33
34
35
36
37
38
 
# File 'lib/phusion_passenger/platform_info/linux.rb', line 31

def self.linux_distro
	tags = linux_distro_tags
	if tags
		return tags.first
	else
		return nil
	end
end

.linux_distro_tags ⇒ Object

Autodetects the current Linux distribution and return a number of identifier tags. The first tag identifies the distribution while the other tags indicate which distributions it is likely compatible with. Returns nil if the operating system is not Linux.



44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
 
# File 'lib/phusion_passenger/platform_info/linux.rb', line 44

def self.linux_distro_tags
	if os_name != "linux"
		return nil
	end
	lsb_release = read_file("/etc/lsb-release")
	if lsb_release =~ /Ubuntu/
		return [:ubuntu, :debian]
	elsif File.exist?("/etc/debian_version")
		return [:debian]
	elsif File.exist?("/etc/redhat-release")
		redhat_release = read_file("/etc/redhat-release")
		if redhat_release =~ /CentOS/
			return [:centos, :redhat]
		elsif redhat_release =~ /Fedora/
			return [:fedora, :redhat]
		elsif redhat_release =~ /Mandriva/
			return [:mandriva, :redhat]
		else
			# On official RHEL distros, the content is in the form of
			# "Red Hat Enterprise Linux Server release 5.1 (Tikanga)"
			return [:rhel, :redhat]
		end
	elsif File.exist?("/etc/system-release")
		system_release = read_file("/etc/system-release")
		if system_release =~ /Amazon Linux/
			return [:amazon, :redhat]
		else
			return [:unknown]
		end
	elsif File.exist?("/etc/suse-release")
		return [:suse]
	elsif File.exist?("/etc/gentoo-release")
		return [:gentoo]
	else
		return [:unknown]
	end
	# TODO: Slackware
end

.locate_ruby_tool(name) ⇒ Object

Locates a Ruby tool command, e.g. ‘gem’, ‘rake’, ‘bundle’, etc. Instead of naively looking in $PATH, this function uses a variety of search heuristics to find the command that’s really associated with the current Ruby interpreter. It should never locate a command that’s actually associated with a different Ruby interpreter. Returns nil when nothing’s found.



357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
 
# File 'lib/phusion_passenger/platform_info/ruby.rb', line 357

def self.locate_ruby_tool(name)
	result = locate_ruby_tool_by_basename(name)
	if !result
		exeext = rb_config['EXEEXT']
		exeext = nil if exeext.empty?
		if exeext
			result = locate_ruby_tool_by_basename("#{name}#{exeext}")
		end
		if !result
			result = locate_ruby_tool_by_basename(transform_according_to_ruby_exec_format(name))
		end
		if !result && exeext
			result = locate_ruby_tool_by_basename(transform_according_to_ruby_exec_format(name) + exeext)
		end
	end
	return result
end

.log_implementation ⇒ Object 



202
203
204
 
# File 'lib/phusion_passenger/platform_info.rb', line 202

def self.log_implementation
	return @@log_implementation
end

.log_implementation=(impl) ⇒ Object 



198
199
200
 
# File 'lib/phusion_passenger/platform_info.rb', line 198

def self.log_implementation=(impl)
	@@log_implementation = impl
end

.make ⇒ Object 



513
514
515
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 513

def self.make
	return string_env('MAKE', find_command('make'))
end

.os_name ⇒ Object

Returns the operating system’s name. This name is in lowercase and contains no spaces, and thus is suitable to be used in some kind of ID. E.g. “linux”, “macosx”.



32
33
34
35
36
37
38
39
40
 
# File 'lib/phusion_passenger/platform_info/operating_system.rb', line 32

def self.os_name
	if rb_config['target_os'] =~ /darwin/ && (sw_vers = find_command('sw_vers'))
		return "macosx"
	elsif rb_config['target_os'] == "linux-"
		return "linux"
	else
		return rb_config['target_os']
	end
end

.passenger_needs_ruby_dev_header? ⇒ Boolean

Returns whether Phusion Passenger needs Ruby development headers to be available for the current Ruby implementation.

Returns:

  • (Boolean) 


138
139
140
141
 
# File 'lib/phusion_passenger/platform_info/ruby.rb', line 138

def self.passenger_needs_ruby_dev_header?
	# Too much of a trouble for JRuby. We can do without it.
	return RUBY_ENGINE != "jruby"
end

.portability_ldflags ⇒ Object

Linker flags that should be used for linking every C/C++ program, for portability reasons. These flags should be specified as last when invoking the linker.



34
35
36
37
38
39
40
41
42
43
 
# File 'lib/phusion_passenger/platform_info/cxx_portability.rb', line 34

def self.portability_ldflags
	if os_name =~ /solaris/
		result = '-lxnet -lsocket -lnsl -lpthread'
	else
		result = '-lpthread'
	end
	result << ' -lrt' if has_rt_library?
	result << ' -lmath' if has_math_library?
	return result
end

.rake ⇒ Object

Returns the absolute path to the Rake executable that belongs to the current Ruby interpreter. Returns nil if it doesn’t exist.

The return value may not be the actual correct invocation for Rake. Use rake_command for that.



169
170
171
 
# File 'lib/phusion_passenger/platform_info/ruby.rb', line 169

def self.rake
	return locate_ruby_tool('rake')
end

.rake_command ⇒ Object

Returns the correct command string for invoking the Rake executable that belongs to the current Ruby interpreter. Returns nil if Rake is not found.



177
178
179
180
181
182
183
184
185
186
187
188
189
190
 
# File 'lib/phusion_passenger/platform_info/ruby.rb', line 177

def self.rake_command
	filename = rake
	# If the Rake executable is a Ruby program then we need to run
	# it in the correct Ruby interpreter just in case Rake doesn't
	# have the correct shebang line; we don't want a totally different
	# Ruby than the current one to be invoked.
	if filename && is_ruby_program?(filename)
		return "#{ruby_command} #{filename}"
	else
		# If it's not a Ruby program then it's probably a wrapper
		# script as is the case with e.g. RVM (~/.rvm/wrappers).
		return filename
	end
end

.rb_config ⇒ Object 



318
319
320
321
322
323
324
 
# File 'lib/phusion_passenger/platform_info.rb', line 318

def self.rb_config
	if defined?(::RbConfig)
		return ::RbConfig::CONFIG
	else
		return ::Config::CONFIG
	end
end

.read_file(filename) ⇒ Object 



220
221
222
223
224
 
# File 'lib/phusion_passenger/platform_info.rb', line 220

def self.read_file(filename)
	return File.read(filename)
rescue
	return ""
end

.requires_no_tls_direct_seg_refs? ⇒ Boolean

Returns:

  • (Boolean) 


160
161
162
 
# File 'lib/phusion_passenger/platform_info/operating_system.rb', line 160

def self.requires_no_tls_direct_seg_refs?
	return File.exists?("/proc/xen/capabilities") && cpu_architectures[0] == "x86"
end

.rspec ⇒ Object

Returns the absolute path to the RSpec runner program that belongs to the current Ruby interpreter. Returns nil if it doesn’t exist.



196
197
198
 
# File 'lib/phusion_passenger/platform_info/ruby.rb', line 196

def self.rspec
	return locate_ruby_tool('rspec')
end

.ruby_command ⇒ Object

Returns correct command for invoking the current Ruby interpreter. In case of RVM this function will return the path to the RVM wrapper script that executes the current Ruby interpreter in the currently active gem set.



50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
 
# File 'lib/phusion_passenger/platform_info/ruby.rb', line 50

def self.ruby_command
	if in_rvm?
		name = rvm_ruby_string
		dirs = rvm_paths
		if name && dirs
			dirs.each do |dir|
				filename = "#{dir}/wrappers/#{name}/ruby"
				if File.exist?(filename)
					contents = File.open(filename, 'rb') do |f|
						f.read
					end
					# Old wrapper scripts reference $HOME which causes
					# things to blow up when run by a different user.
					if contents.include?("$HOME")
						filename = nil
					end
				else
					filename = nil
				end
				if filename
					return filename
				end
			end

			# Correctness of these commands are confirmed by mpapis.
			# If we ever encounter a case for which this logic is not sufficient,
			# try mpapis' pseudo code:
			# 
			#   rvm_update_prefix  = write_to rvm_path ? "" : "rvmsudo"
			#   rvm_gemhome_prefix  = write_to GEM_HOME ? "" : "rvmsudo"
			#   repair_command  = "#{rvm_update_prefix} rvm get stable && rvm reload && #{rvm_gemhome_prefix} rvm repair all"
			#   wrapper_command = "#{rvm_gemhome_prefix} rvm wrapper #{rvm_ruby_string} --no-prefix --all"
			case rvm_installation_mode
			when :single
				repair_command  = "rvm get stable && rvm reload && rvm repair all"
				wrapper_command = "rvm wrapper #{rvm_ruby_string} --no-prefix --all"
			when :multi
				repair_command  = "rvmsudo rvm get stable && rvm reload && rvmsudo rvm repair all"
				wrapper_command = "rvmsudo rvm wrapper #{rvm_ruby_string} --no-prefix --all"
			when :mixed
				repair_command  = "rvmsudo rvm get stable && rvm reload && rvm repair all"
				wrapper_command = "rvm wrapper #{rvm_ruby_string} --no-prefix --all"
			end

			STDERR.puts "Your RVM wrapper scripts are too old, or some " +
				"wrapper scripts are missing. Please update/regenerate " +
				"them first by running:\n\n" +
				"  #{repair_command}\n\n" +
				"If that doesn't seem to work, please run:\n\n" +
				"  #{wrapper_command}"
			exit 1
		else
			# Something's wrong with the user's RVM installation.
			# Raise an error so that the user knows this instead of
			# having things fail randomly later on.
			# 'name' is guaranteed to be non-nil because rvm_ruby_string
			# already raises an exception on error.
			STDERR.puts "Your RVM installation appears to be broken: the RVM " +
				"path cannot be found. Please fix your RVM installation " +
				"or contact the RVM developers for support."
			exit 1
		end
	else
		return ruby_executable
	end
end

.ruby_executable ⇒ Object

Returns the full path to the current Ruby interpreter’s executable file. This might not be the actual correct command to use for invoking the Ruby interpreter; use ruby_command instead.



121
122
123
124
 
# File 'lib/phusion_passenger/platform_info/ruby.rb', line 121

def self.ruby_executable
	@@ruby_executable ||=
		rb_config['bindir'] + '/' + rb_config['RUBY_INSTALL_NAME'] + rb_config['EXEEXT']
end

.ruby_extension_binary_compatibility_id ⇒ Object

Returns a string that describes the current Ruby interpreter’s extension binary compatibility. A Ruby extension compiled for a certain Ruby interpreter can also be loaded on a different Ruby interpreter with the same binary compatibility identifier.

The result depends on the following factors:

  • Ruby engine name.

  • Ruby extension version. This is not the same as the Ruby language version, which identifies language-level compatibility. This is rather about binary compatibility of extensions. MRI seems to break source compatibility between tiny releases, though patchlevel releases tend to be source and binary compatible.

  • Ruby extension architecture. This is not necessarily the same as the operating system runtime architecture or the CPU architecture. For example, in case of JRuby, the extension architecture is just “java” because all extensions target the Java platform; the architecture the JVM was compiled for has no effect on compatibility. On systems with universal binaries support there may be multiple architectures. In this case the architecture is “universal” because extensions must be able to support all of the Ruby executable’s architectures.

  • The operating system for which the Ruby interpreter was compiled.



59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
 
# File 'lib/phusion_passenger/platform_info/binary_compatibility.rb', line 59

def self.ruby_extension_binary_compatibility_id
	ruby_engine = defined?(RUBY_ENGINE) ? RUBY_ENGINE : "ruby"
	ruby_ext_version = RUBY_VERSION
	if RUBY_PLATFORM =~ /darwin/
		if RUBY_PLATFORM =~ /universal/
			ruby_arch = "universal"
		else
			# OS X <  10.8: something like:
			#   "/opt/ruby-enterprise/bin/ruby: Mach-O 64-bit executable x86_64"
			output = `file -L "#{ruby_executable}"`.strip
			ruby_arch = output.sub(/.* /, '')
			if ruby_arch == "executable"
				# OS X >= 10.8: something like:
				#   "/opt/ruby-enterprise/bin/ruby: Mach-O 64-bit executable"
				if output =~ /Mach-O 64-bit/
					ruby_arch = "x86_64"
				else
					raise "Cannot autodetect the Ruby interpreter's architecture"
				end
			end
		end
	elsif RUBY_PLATFORM == "java"
		ruby_arch = "java"
	else
		ruby_arch = cpu_architectures[0]
	end
	return "#{ruby_engine}-#{ruby_ext_version}-#{ruby_arch}-#{os_name}"
end

.ruby_sudo_command ⇒ Object

Returns either ‘sudo’ or ‘rvmsudo’ depending on whether the current Ruby interpreter is managed by RVM.



320
321
322
323
324
325
326
 
# File 'lib/phusion_passenger/platform_info/ruby.rb', line 320

def self.ruby_sudo_command
	if in_rvm?
		return "rvmsudo"
	else
		return "sudo"
	end
end

.ruby_sudo_shell_command(args = nil) ⇒ Object

Returns a ‘sudo` or `rvmsudo` command that spawns a shell, depending on whether the current Ruby interpreter is managed by RVM.



330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
 
# File 'lib/phusion_passenger/platform_info/ruby.rb', line 330

def self.ruby_sudo_shell_command(args = nil)
	if in_rvm?
		shell = ENV['SHELL'].to_s
		if shell.empty?
			begin
				user = Etc.getpwuid(0)
			rescue ArgumentError
				user = nil
			end
			shell = user.shell if user
			shell = "bash" if !shell || shell.empty?
		end
		result = "rvmsudo "
		result << "#{args} " if args
		result << shell
		return result
	else
		return "sudo -s #{args}".strip
	end
end

.ruby_supports_fork? ⇒ Boolean

Returns whether the Ruby interpreter supports process forking.

Returns:

  • (Boolean) 


127
128
129
130
131
132
133
134
 
# File 'lib/phusion_passenger/platform_info/ruby.rb', line 127

def self.ruby_supports_fork?
	# MRI >= 1.9.2's respond_to? returns false for methods
	# that are not implemented.
	return Process.respond_to?(:fork) &&
		RUBY_ENGINE != "jruby" &&
		RUBY_ENGINE != "macruby" &&
		rb_config['target_os'] !~ /mswin|windows|mingw/
end

.rvm_installation_mode ⇒ Object

Returns the RVM installation mode: :single - RVM is installed in single-user mode. :multi - RVM is installed in multi-user mode. :mixed - RVM is in a mixed-mode installation. nil - The current Ruby interpreter is not using RVM.



302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
 
# File 'lib/phusion_passenger/platform_info/ruby.rb', line 302

def self.rvm_installation_mode
	if in_rvm?
		if ENV['rvm_path'] =~ /\.rvm/
			return :single
		else
			if GEM_HOME =~ /\.rvm/
				return :mixed
			else
				return :multi
			end
		end
	else
		return nil
	end
end

.rvm_paths ⇒ Object

If the current Ruby interpreter is managed by RVM, returns all directories in which RVM places its working files. This is usually ~/.rvm or /usr/local/rvm, but in mixed-mode installations there can be multiple such paths.

Otherwise returns nil.



213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
 
# File 'lib/phusion_passenger/platform_info/ruby.rb', line 213

def self.rvm_paths
	if in_rvm?
		result = []
		[ENV['rvm_path'], "~/.rvm", "/usr/local/rvm"].each do |path|
			next if path.nil?
			path = File.expand_path(path)
			rubies_path = File.join(path, 'rubies')
			if File.directory?(path) && File.directory?(rubies_path)
				result << path
			end
		end
		if result.empty?
			# Failure to locate the RVM path is probably caused by the
			# user customizing $rvm_path. Older RVM versions don't
			# export $rvm_path, making us unable to detect its value.
			STDERR.puts "Unable to locate the RVM path. Your RVM installation " +
				"is probably too old. Please update it with " +
				"'rvm get head && rvm reload && rvm repair all'."
			exit 1
		else
			return result
		end
	else
		return nil
	end
end

.rvm_ruby_string ⇒ Object

If the current Ruby interpreter is managed by RVM, returns the RVM name which identifies the current Ruby interpreter plus the currently active gemset, e.g. something like this: “ruby-1.9.2-p0@mygemset”

Returns nil otherwise.



247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
 
# File 'lib/phusion_passenger/platform_info/ruby.rb', line 247

def self.rvm_ruby_string
	if in_rvm?
		# RVM used to export the necessary information through
		# environment variables, but doesn't always do that anymore
		# in the latest versions in order to fight env var pollution.
		# Scanning $LOAD_PATH seems to be the only way to obtain
		# the information.
		
		# Getting the RVM name of the Ruby interpreter ("ruby-1.9.2")
		# isn't so hard, we can extract it from the #ruby_executable
		# string. Getting the gemset name is a bit harder, so let's
		# try various strategies...
		
		# $GEM_HOME usually contains the gem set name.
		# It may be something like:
		#   /Users/hongli/.rvm/gems/ruby-1.9.3-p392
		# But also:
		#   /home/bitnami/.rvm/gems/ruby-1.9.3-p385-perf@njist325/ruby/1.9.1
		if GEM_HOME && GEM_HOME =~ %r{rvm/gems/(.+)}
			return $1.sub(/\/.*/, '')
		end
		
		# User somehow managed to nuke $GEM_HOME. Extract info
		# from $LOAD_PATH.
		matching_path = $LOAD_PATH.find_all do |item|
			item.include?("rvm/gems/")
		end
		if matching_path && !matching_path.empty?
			subpath = matching_path.to_s.gsub(/^.*rvm\/gems\//, '')
			result = subpath.split('/').first
			return result if result
		end

		# On Ruby 1.9, $LOAD_PATH does not contain any gem paths until
		# at least one gem has been required so the above can fail.
		# We're out of options now, we can't detect the gem set.
		# Raise an exception so that the user knows what's going on
		# instead of having things fail in obscure ways later.
		STDERR.puts "Unable to autodetect the currently active RVM gem " +
			"set name. This could happen if you ran this program using 'sudo' " +
			"instead of 'rvmsudo'. When using RVM, you're always supposed to " +
			"use 'rvmsudo' instead of 'sudo!'.\n\n" +
			"Please try rerunning this program using 'rvmsudo'. If that " +
			"doesn't help, please contact this program's author for support."
		exit 1
	end
	return nil
end

.string_env(name, default_value = nil) ⇒ Object 



211
212
213
214
215
216
217
218
 
# File 'lib/phusion_passenger/platform_info.rb', line 211

def self.string_env(name, default_value = nil)
	value = ENV[name]
	if value.nil? || value.empty?
		return default_value
	else
		return value
	end
end

.supports_lfence_instruction? ⇒ Boolean

Returns whether the OS’s main CPU architecture supports the x86/x86_64 lfence instruction.

Returns:

  • (Boolean) 


147
148
149
150
151
152
153
154
155
156
157
 
# File 'lib/phusion_passenger/platform_info/operating_system.rb', line 147

def self.supports_lfence_instruction?
	arch = cpu_architectures[0]
	return arch == "x86_64" || (arch == "x86" &&
		try_compile_and_run("Checking for lfence instruction support", :c, %Q{
			int
			main() {
				__asm__ __volatile__ ("lfence" ::: "memory");
				return 0;
			}
		}))
end

.supports_sfence_instruction? ⇒ Boolean

Returns whether the OS’s main CPU architecture supports the x86/x86_64 sfence instruction.

Returns:

  • (Boolean) 


132
133
134
135
136
137
138
139
140
141
142
 
# File 'lib/phusion_passenger/platform_info/operating_system.rb', line 132

def self.supports_sfence_instruction?
	arch = cpu_architectures[0]
	return arch == "x86_64" || (arch == "x86" &&
		try_compile_and_run("Checking for sfence instruction support", :c, %Q{
			int
			main() {
				__asm__ __volatile__ ("sfence" ::: "memory");
				return 0;
			}
		}))
end

.tmpdir ⇒ Object 



226
227
228
229
230
231
232
233
 
# File 'lib/phusion_passenger/platform_info.rb', line 226

def self.tmpdir
	result = ENV['TMPDIR']
	if result && !result.empty?
		return result.sub(/\/+\Z/, '')
	else
		return '/tmp'
	end
end

.tmpexedir ⇒ Object

Returns the directory in which test executables should be placed. The returned directory is guaranteed to be writable and guaranteed to not be mounted with the ‘noexec’ option. If no such directory can be found then it will raise a PlatformInfo::RuntimeError with an appropriate error message.

Raises:



241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
 
# File 'lib/phusion_passenger/platform_info.rb', line 241

def self.tmpexedir
	basename = "test-exe.#{Process.pid}.#{Thread.current.object_id}"
	attempts = []
	
	dir = tmpdir
	filename = "#{dir}/#{basename}"
	begin
		File.open(filename, 'w') do |f|
			f.puts("#!/bin/sh")
		end
		File.chmod(0700, filename)
		if system(filename)
			return dir
		else
			attempts << { :dir => dir,
				:error => "This directory's filesystem is mounted with the 'noexec' option." }
		end
	rescue Errno::ENOENT
		attempts << { :dir => dir, :error => "This directory doesn't exist." }
	rescue Errno::EACCES
		attempts << { :dir => dir, :error => "This program doesn't have permission to write to this directory." }
	rescue SystemCallError => e
		attempts << { :dir => dir, :error => e.message }
	ensure
		File.unlink(filename) rescue nil
	end
	
	dir = Dir.pwd
	filename = "#{dir}/#{basename}"
	begin
		File.open(filename, 'w') do |f|
			f.puts("#!/bin/sh")
		end
		File.chmod(0700, filename)
		if system(filename)
			return dir
		else
			attempts << { :dir => dir,
				:error => "This directory's filesystem is mounted with the 'noexec' option." }
		end
	rescue Errno::ENOENT
		attempts << { :dir => dir, :error => "This directory doesn't exist." }
	rescue Errno::EACCES
		attempts << { :dir => dir, :error => "This program doesn't have permission to write to this directory." }
	rescue SystemCallError => e
		attempts << { :dir => dir, :error => e.message }
	ensure
		File.unlink(filename) rescue nil
	end
	
	message = "ERROR: Cannot find suitable temporary directory\n" +
		"In order to run certain tests, this program " +
		"must be able to write temporary\n" +
		"executable files to some directory. However no such " +
		"directory can be found. \n" +
		"The following directories have been tried:\n\n"
	attempts.each do |attempt|
		message << " * #{attempt[:dir]}\n"
		message << "   #{attempt[:error]}\n"
	end
	message << "\nYou can solve this problem by telling this program what directory to write\n" <<
		"temporary executable files to, as follows:\n" <<
		"\n" <<
		"  Set the $TMPDIR environment variable to the desired directory's filename and\n" <<
		"  re-run this program.\n" <<
		"\n" <<
		"Notes:\n" <<
		"\n" <<
		" * If you're using 'sudo'/'rvmsudo', remember that 'sudo'/'rvmsudo' unsets all\n" <<
		"   environment variables, so you must set the environment variable *after*\n" <<
		"   having gained root privileges.\n" <<
		" * The directory you choose must writeable and must not be mounted with the\n" <<
		"   'noexec' option."
	raise RuntimeError, message
end

.try_compile(description, language, source, flags = nil) ⇒ Object 



234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 234

def self.try_compile(description, language, source, flags = nil)
	extension = detect_language_extension(language)
	create_temp_file("passenger-compile-check.#{extension}") do |filename, f|
		f.puts(source)
		f.close
		begin
			command = create_compiler_command(language,
				"-c '#{filename}' -o '#{filename}.o'",
				flags)
			return run_compiler(description, command, filename, source)
		ensure
			File.unlink("#{filename}.o") rescue nil
		end
	end
end

.try_compile_and_run(description, language, source, flags = nil) ⇒ Object 



266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 266

def self.try_compile_and_run(description, language, source, flags = nil)
	extension = detect_language_extension(language)
	create_temp_file("passenger-run-check.#{extension}", tmpexedir) do |filename, f|
		f.puts(source)
		f.close
		begin
			command = create_compiler_command(language,
				"'#{filename}' -o '#{filename}.out'",
				flags, true)
			if run_compiler(description, command, filename, source)
				log("Running #{filename}.out")
				begin
					output = `'#{filename}.out' 2>&1`
				rescue SystemCallError => e
					log("Command failed: #{e}")
					return false
				end
				status = $?.exitstatus
				log("Command exited with status #{status}. Output:\n--------------\n#{output}\n--------------")
				return status == 0
			else
				return false
			end
		ensure
			File.unlink("#{filename}.out") rescue nil
		end
	end
end

.try_link(description, language, source, flags = nil) ⇒ Object 



250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 250

def self.try_link(description, language, source, flags = nil)
	extension = detect_language_extension(language)
	create_temp_file("passenger-link-check.#{extension}") do |filename, f|
		f.puts(source)
		f.close
		begin
			command = create_compiler_command(language,
				"'#{filename}' -o '#{filename}.out'",
				flags, true)
			return run_compiler(description, command, filename, source)
		ensure
			File.unlink("#{filename}.out") rescue nil
		end
	end
end

.verbose=(val) ⇒ Object 



190
191
192
 
# File 'lib/phusion_passenger/platform_info.rb', line 190

def self.verbose=(val)
	@@verbose = val
end

.verbose? ⇒ Boolean

Returns:

  • (Boolean) 


194
195
196
 
# File 'lib/phusion_passenger/platform_info.rb', line 194

def self.verbose?
	return @@verbose
end

.xcode_select_version ⇒ Object 



541
542
543
544
545
546
547
548
 
# File 'lib/phusion_passenger/platform_info/compiler.rb', line 541

def self.xcode_select_version
	if find_command('xcode-select')
		`xcode-select --version` =~ /version (.+)\./
		return $1
	else
		return nil
	end
end

.zlib_flags ⇒ Object 



29
30
31
 
# File 'lib/phusion_passenger/platform_info/zlib.rb', line 29

def self.zlib_flags
	return nil
end

.zlib_libs ⇒ Object 



33
34
35
 
# File 'lib/phusion_passenger/platform_info/zlib.rb', line 33

def self.zlib_libs
	return '-lz'
end