From: Daniel Berger <djberge@...>
Date: 2003-08-29T03:23:02+09:00
Subject: [ANN] sys-win32etc 0.0.2

Hi all,

I'm happy to announce the release of sys-win32etc 0.0.2.  This is an
ALPHA release.

What is it?  This is my attempt to port the Etc module to Win32 systems
(well, NT, 2000 and XP anyway).  If all goes well, I hope to get Matz to
include this as part of core Ruby.

HELP WANTED!  See "Where I need help" below.

Changes since 0.0.1
===================
- Replaced most calls to NetQueryDisplayInformation() with less unicode
  friendly, but easier, method calls.
- The group() method now returns local group info as well (only global
groups
  were returned before).
- All methods except getlogin() now accept a server name as an optional
  argument.  If provided, lookups are done against that server instead
of the
  local machine.
- Calling group() or passwd() in non-block form now returns nil, as it
does
  on *nix.
- Test suite and documentation changes to reflect changes in code.


Synopsis 
======== 
require "win32etc" 

puts "Login: " + Win32Etc.getlogin 

p Win32Etc.getpwnam("Guest","\\some_server") 
p Win32Etc.getpwuid(512) 
p Win32Etc.getgrnam("Guests") 
p Win32Etc.getgrgid(500,"\\some_server") 

Win32Etc.passwd{ |s| 
   p s 
} 

Win32Etc.group("\\some_server"){ |g| 
   p g 
}

Where I need help
=================
Memory leaks.  Don't panic - these are only an issue if you do repeated
calls in a tight loop of some kind.  Single calls are harmless.  I don't
know where they're coming from or what I can do about it.

Remote server testing - I don't have a machine to test against for
calling a method against a remote server instead of the local machine. 
Testing much appreciated on that front.

Insight into why I should or shouldn't use NetQueryDisplayInformation()
instead of NetGroupEnum(), etc.  Hopefully, something beyond, "Because
the MSDN site says so".

For more information
====================
For general info on porting *nix to Windows see
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnucmg/html/ucmgch09.asp

See http://msdn.microsoft.com/library/default.asp to search for API
info.

Regards,

Dan