1AppConfig::Sys(3) User Contributed Perl Documentation AppConfig::Sys(3)
2
3
4
6 AppConfig::Sys - Perl5 module defining platform-specific information
7 and methods for other AppConfig::* modules.
8
10 use AppConfig::Sys;
11 my $sys = AppConfig::Sys->new();
12
13 @fields = $sys->getpwuid($userid);
14 @fields = $sys->getpwnam($username);
15
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
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
61 Andy Wardley, <abw@wardley.org>
62
64 Copyright (C) 1997-2007 Andy Wardley. All Rights Reserved.
65
66 Copyright (C) 1997,1998 Canon Research Centre Europe Ltd.
67
68 This module is free software; you can redistribute it and/or modify it
69 under the term of the Perl Artistic License.
70
72 AppConfig, AppConfig::File
73
74
75
76perl v5.38.0 2023-07-20 AppConfig::Sys(3)