win32-process 0.8.3

The win32-process library implements several Process methods that are either unimplemented or dysfunctional in some way in the default Ruby implementation. Examples include Process.kill, Process.uid and Process.create.

Homepage: https://github.com/djberg96/win32-process

Platform: Rubygems

Language: Ruby

License: Artistic-2.0

View on registry: https://rubygems.org/gems/win32-process/versions/0.8.3

Documentation: http://www.rubydoc.info/gems/win32-process/0.8.3

Direct download link: https://rubygems.org/downloads/win32-process-0.8.3.gem

Install: gem install win32-process -v 0.8.3


= Description
  This library provides analogues of the :getpriority, :setpriority, :getrlimit,
  :setrlimit and :uid methods for MS Windows. It also adds the new methods :job?,
  :get_affinity, and :create, and redefines the :kill method.
 
= Prerequisites
  * ffi
  * sys-proctable (dev only)
  * test-unit 2 (dev only)

= Supported Platforms
  This library is supported on Windows 2000 or later.

= Installation
  gem install win32-process

= Synopsis
  require 'win32/process'

  p Process.job? # => true or false

  info = Process.create(
    :app_name         => "notepad.exe",
    :creation_flags   => Process::DETACHED_PROCESS,
    :process_inherit  => false,
    :thread_inherit   => true,
    :cwd              => "C:\\"
  )

  p info.process_id
	
= Developer's Notes
== Removal of Process.fork in release 0.7.0
   The Process.fork method was originally experimental but it has never
   been particularly useful in practice. On top of that, it required special
   implementations of the Process.waitXXX methods, so it was a maintenance
   issue as well.
   
   With Ruby 1.9 now becoming standard and its addition of Process.spawn
   and friends (and concomitant support for the Process.waitXXX methods) I
   felt it was time to remove it.

   You can still simulate Process.fork if you like using Process.create, which
   is how it was implemented internally anyway. A better solution might be
   to follow in the footsteps of ActiveState Perl, which uses native threads
   to simulate fork on Windows.
	
== Changes in the custom Process.kill method for 0.7.0
   The Process.kill method in 0.7.0 more closely matches the spec now, but
   the internal method for killing processes is still nicer for most signals.
   With the release of 0.7.0 users can now specify options that provide finer
   control over how a process is killed. See the documentation for details. 

== The removal of the custom Process.ppid method
   This was added at some point in the Ruby 1.9 dev cycle so it was removed
   from this library.

= Known Issues
  JRuby doesn't seem to like SIGBRK for Process.kill.

  Any issues or bugs should be reported on the project page at
  https://github.com/djberg96/win32-process.
	
= License
  Artistic 2.0
	
= Copyright
  (C) 2003-2015 Daniel J. Berger
  All Rights Reserved
		
= Warranty
  This library is provided "as is" and without any express or
  implied warranties, including, without limitation, the implied
  warranties of merchantability and fitness for a particular purpose.
	
= Author(s)
  Park Heesob	
  Daniel J. Berger
Sustain

Releases

0.8.3 December 16, 2015
0.8.2 October 15, 2015
0.8.1 September 03, 2015
0.8.0 April 29, 2015
0.7.5 March 03, 2015
0.7.4 October 21, 2013
0.7.3 September 25, 2013
0.7.2 April 08, 2013
0.7.1 January 03, 2013
0.7.0 August 22, 2012
See all 26 releases

Project Statistics

SourceRank 13
Dependencies 1
Dependent projects 29
Dependent repositories 1.17K
Total releases 26
Latest release
First release
Stars 16
Forks 7
Watchers 3
Contributors 3
Repo Size: 209 KB

Top Contributors See all

Daniel Berger Martin Thiede phasis68

Something wrong with this page? Make a suggestion

Export .ABOUT file for this library

Last synced: 2016-11-18 01:50:49 UTC

Login to resync this project