mirror of
				https://github.com/ruby/ruby.git
				synced 2022-11-09 12:17:21 -05:00 
			
		
		
		
	 eaddc4a94b
			
		
	
	
		eaddc4a94b
		
	
	
	
	
		
			
			code. git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@1629 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
		
			
				
	
	
		
			72 lines
		
	
	
	
		
			1.9 KiB
		
	
	
	
		
			Text
		
	
	
	
	
	
			
		
		
	
	
			72 lines
		
	
	
	
		
			1.9 KiB
		
	
	
	
		
			Text
		
	
	
	
	
	
| .\" etc.txt -  -*- Indented-Text -*- created at: Fri Jul 14 00:47:15 JST 1995
 | |
| 
 | |
| ** Etc(Module)
 | |
| 
 | |
| The module to retrieve information under /etc directory.  Available
 | |
| only on UNIX platforms.  All operations defined in this module are
 | |
| module functions, so that you can include Etc module into your class.
 | |
| 
 | |
| Module Function:
 | |
| 
 | |
|    getlogin
 | |
| 
 | |
| 	returns login name of the user.  It this fails, try getpwuid().
 | |
| 
 | |
|    getpwnam(name)
 | |
| 
 | |
| 	searches in /etc/passwd file (or equivalent database), and
 | |
| 	returns password entry for the user.  The return value is an
 | |
| 	passwd structure, which has members described below.
 | |
| 
 | |
| 	  struct passwd
 | |
| 	    name 	# user name(string)
 | |
| 	    passwd	# encrypted password(string)
 | |
| 	    uid		# user ID(integer)
 | |
| 	    gid		# group ID(integer)
 | |
| 	    gecos	# gecos field(string)
 | |
| 	    dir		# home directory(string)
 | |
| 	    shell	# login shell(string)
 | |
| 	    # members below are optional
 | |
| 	    change	# password change time(integer)
 | |
| 	    quota	# quota value(integer)
 | |
| 	    age		# password age(integer)
 | |
| 	    class	# user access class(string)
 | |
| 	    comment	# comment(string)
 | |
| 	    expire	# account expiration time(integer)	    
 | |
| 	  end
 | |
| 
 | |
| 	See getpwnam(3) for detail.
 | |
| 
 | |
|    getpwuid([uid])
 | |
| 
 | |
| 	returns passwd entry for the specified user id.  If uid is
 | |
| 	ommitted, use the value from getuid().  See getpwuid(3) for
 | |
| 	detail.
 | |
| 
 | |
|    getgrgid(gid)
 | |
| 
 | |
| 	searches in /etc/group file (or equivalent database), and
 | |
| 	returns group entry for the group id.  The return value is an
 | |
| 	group structure, which has members described below.
 | |
| 
 | |
| 	  struct group
 | |
| 	    name 	# group name(string)
 | |
| 	    passwd	# group password(string)
 | |
| 	    gid		# group ID(integer)
 | |
| 	    mem		# array of the group member names
 | |
| 	  end
 | |
| 
 | |
| 	See getgrgid(3) for detail.
 | |
| 
 | |
|    getgrnam(name)
 | |
| 
 | |
| 	returns the group entry for the specified name.  The return
 | |
| 	value is the group structure.  See getgrnam(3) for detail.
 | |
| 
 | |
|    group
 | |
| 
 | |
| 	iterates over all group entries.
 | |
| 
 | |
|    passwd
 | |
| 
 | |
| 	iterates over all passwd entries.
 |