# AppConfig::Sys - Perl5 module defining platform-specific information an... - perldoc - [phpMan]

## NAME
    [AppConfig::Sys](https://www.chedong.com/phpMan.php/perldoc/AppConfig%3A%3ASys/markdown) - Perl5 module defining platform-specific information and methods for other
    AppConfig::* modules.

## SYNOPSIS
        use [AppConfig::Sys](https://www.chedong.com/phpMan.php/perldoc/AppConfig%3A%3ASys/markdown);
        my $sys = [AppConfig::Sys](https://www.chedong.com/phpMan.php/perldoc/AppConfig%3A%3ASys/markdown)->new();

        @fields = $sys->getpwuid($userid);
        @fields = $sys->getpwnam($username);

## OVERVIEW
    [AppConfig::Sys](https://www.chedong.com/phpMan.php/perldoc/AppConfig%3A%3ASys/markdown) is a Perl5 module provides platform-specific information and operations as
    required by other AppConfig::* modules.

    [AppConfig::Sys](https://www.chedong.com/phpMan.php/perldoc/AppConfig%3A%3ASys/markdown) is distributed as part of the AppConfig bundle.

## DESCRIPTION
  USING THE [AppConfig::Sys](https://www.chedong.com/phpMan.php/perldoc/AppConfig%3A%3ASys/markdown) MODULE
    To import and use the [AppConfig::Sys](https://www.chedong.com/phpMan.php/perldoc/AppConfig%3A%3ASys/markdown) module the following line should appear in your Perl
    script:

         use [AppConfig::Sys](https://www.chedong.com/phpMan.php/perldoc/AppConfig%3A%3ASys/markdown);

    [AppConfig::Sys](https://www.chedong.com/phpMan.php/perldoc/AppConfig%3A%3ASys/markdown) is implemented using object-oriented methods. A new [AppConfig::Sys](https://www.chedong.com/phpMan.php/perldoc/AppConfig%3A%3ASys/markdown) object is
    created and initialised using the [AppConfig::Sys](https://www.chedong.com/phpMan.php/perldoc/AppConfig%3A%3ASys/markdown)->new() method. This returns a reference to a
    new [AppConfig::Sys](https://www.chedong.com/phpMan.php/perldoc/AppConfig%3A%3ASys/markdown) object.

        my $sys = [AppConfig::Sys](https://www.chedong.com/phpMan.php/perldoc/AppConfig%3A%3ASys/markdown)->new();

    This will attempt to detect your operating system and create a reference to a new [AppConfig::Sys](https://www.chedong.com/phpMan.php/perldoc/AppConfig%3A%3ASys/markdown)
    object that is applicable to your platform. You may explicitly specify an operating system name
    to override this automatic detection:

        $unix_sys = [AppConfig::Sys](https://www.chedong.com/phpMan.php/perldoc/AppConfig%3A%3ASys/markdown)->new("Unix");

    Alternatively, the package variable $[AppConfig::Sys::OS](https://www.chedong.com/phpMan.php/perldoc/AppConfig%3A%3ASys%3A%3AOS/markdown) can be set to an operating system name.
    The valid operating system names are: Win32, VMS, Mac, OS2 and Unix. They are not case-specific.

### [AppConfig::Sys](https://www.chedong.com/phpMan.php/perldoc/AppConfig%3A%3ASys/markdown) METHODS
    [AppConfig::Sys](https://www.chedong.com/phpMan.php/perldoc/AppConfig%3A%3ASys/markdown) defines the following methods:

### getpwnam
        Calls the system function getpwnam() if available and returns the result. Returns undef if
        not available. The can_getpwnam() method can be called to determine if this function is
        available.

### getpwuid
        Calls the system function getpwuid() if available and returns the result. Returns undef if
        not available. The can_getpwuid() method can be called to determine if this function is
        available.

## AUTHOR
    Andy Wardley, <<abw@wardley.org>>

## COPYRIGHT
    Copyright (C) 1997-2007 Andy Wardley. All Rights Reserved.

    Copyright (C) 1997,1998 Canon Research Centre Europe Ltd.

    This module is free software; you can redistribute it and/or modify it under the term of the
    Perl Artistic License.

## SEE ALSO
    AppConfig, [AppConfig::File](https://www.chedong.com/phpMan.php/perldoc/AppConfig%3A%3AFile/markdown)