1AppConfig::Sys(3)     User Contributed Perl Documentation    AppConfig::Sys(3)
2
3
4

NAME

6       AppConfig::Sys - Perl5 module defining platform-specific information
7       and methods for other AppConfig::* modules.
8

SYNOPSIS

10           use AppConfig::Sys;
11           my $sys = AppConfig::Sys->new();
12
13           @fields = $sys->getpwuid($userid);
14           @fields = $sys->getpwnam($username);
15

OVERVIEW

17       AppConfig::Sys is a Perl5 module provides platform-specific information
18       and operations as required by other AppConfig::* modules.
19
20       AppConfig::Sys is distributed as part of the AppConfig bundle.
21

DESCRIPTION

23   USING THE AppConfig::Sys MODULE
24       To import and use the AppConfig::Sys module the following line should
25       appear in your Perl script:
26
27            use AppConfig::Sys;
28
29       AppConfig::Sys is implemented using object-oriented methods.  A new
30       AppConfig::Sys object is created and initialised using the
31       AppConfig::Sys->new() method.  This returns a reference to a new
32       AppConfig::Sys object.
33
34           my $sys = AppConfig::Sys->new();
35
36       This will attempt to detect your operating system and create a
37       reference to a new AppConfig::Sys object that is applicable to your
38       platform.  You may explicitly specify an operating system name to
39       override this automatic detection:
40
41           $unix_sys = AppConfig::Sys->new("Unix");
42
43       Alternatively, the package variable $AppConfig::Sys::OS can be set to
44       an operating system name.  The valid operating system names are: Win32,
45       VMS, Mac, OS2 and Unix.  They are not case-specific.
46
47   AppConfig::Sys METHODS
48       AppConfig::Sys defines the following methods:
49
50       getpwnam()
51           Calls the system function getpwnam() if available and returns the
52           result.  Returns undef if not available.  The can_getpwnam() method
53           can be called to determine if this function is available.
54
55       getpwuid()
56           Calls the system function getpwuid() if available and returns the
57           result.  Returns undef if not available.  The can_getpwuid() method
58           can be called to determine if this function is available.
59
60
61

AUTHOR

63       Andy Wardley, <abw@wardley.org>
64

66       Copyright (C) 1997-2007 Andy Wardley.  All Rights Reserved.
67
68       Copyright (C) 1997,1998 Canon Research Centre Europe Ltd.
69
70       This module is free software; you can redistribute it and/or modify it
71       under the term of the Perl Artistic License.
72

SEE ALSO

74       AppConfig, AppConfig::File
75
76
77
78perl v5.10.1                      2007-05-30                 AppConfig::Sys(3)
Impressum