Os (plexus-utils 4.0.0-alpha-2 API)

java.lang.Object
- org.codehaus.plexus.util.Os

```
public class Os
extends Object
```
Condition that tests the OS type.

Since:

1.0

Author:

Stefan Bodewig, Magesh Umasankar, Brian Fox

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`FAMILY_DOS`
`static String`	`FAMILY_MAC`
`static String`	`FAMILY_NETWARE`
`static String`	`FAMILY_OPENVMS`
`static String`	`FAMILY_OS2`
`static String`	`FAMILY_OS400`
`static String`	`FAMILY_TANDEM`
`static String`	`FAMILY_UNIX`
`static String`	`FAMILY_WIN9X`
`static String`	`FAMILY_WINDOWS`
`static String`	`FAMILY_ZOS`
`static String`	`OS_ARCH`
`static String`	`OS_FAMILY`
`static String`	`OS_NAME`
`static String`	`OS_VERSION`

Constructor Summary

Constructors
Constructor and Description

Os()
Default constructor

Os(String family)
Constructor that sets the family attribute

Constructors
Constructor and Description
`Os()` Default constructor
`Os(String family)` Constructor that sets the family attribute

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`eval()`
`static Set<String>`	`getValidFamilies()`
`static boolean`	`isArch(String arch)` Determines if the current OS matches the given OS architecture.
`static boolean`	`isFamily(String family)` Determines if the current OS matches the given OS family.
`static boolean`	`isName(String name)` Determines if the current OS matches the given OS name.
`static boolean`	`isOs(String family, String name, String arch, String version)` Determines if the current OS matches the given OS family, name, architecture and version.
`static boolean`	`isValidFamily(String theFamily)` Helper method to check if the given family is in the following list: dos mac netware os/2 tandem unix windows win9x z/os os/400 openvms
`static boolean`	`isVersion(String version)` Determines if the current OS matches the given OS version.
`void`	`setArch(String arch)` Sets the desired OS architecture
`void`	`setFamily(String f)` Sets the desired OS family type
`void`	`setName(String name)` Sets the desired OS name
`void`	`setVersion(String version)` Sets the desired OS version

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - FAMILY_DOS
```
public static final String FAMILY_DOS
```
    See Also:
    
    Constant Field Values
  - FAMILY_MAC
```
public static final String FAMILY_MAC
```
    See Also:
    
    Constant Field Values
  - FAMILY_NETWARE
```
public static final String FAMILY_NETWARE
```
    See Also:
    
    Constant Field Values
  - FAMILY_OS2
```
public static final String FAMILY_OS2
```
    See Also:
    
    Constant Field Values
  - FAMILY_TANDEM
```
public static final String FAMILY_TANDEM
```
    See Also:
    
    Constant Field Values
  - FAMILY_UNIX
```
public static final String FAMILY_UNIX
```
    See Also:
    
    Constant Field Values
  - FAMILY_WINDOWS
```
public static final String FAMILY_WINDOWS
```
    See Also:
    
    Constant Field Values
  - FAMILY_WIN9X
```
public static final String FAMILY_WIN9X
```
    See Also:
    
    Constant Field Values
  - FAMILY_ZOS
```
public static final String FAMILY_ZOS
```
    See Also:
    
    Constant Field Values
  - FAMILY_OS400
```
public static final String FAMILY_OS400
```
    See Also:
    
    Constant Field Values
  - FAMILY_OPENVMS
```
public static final String FAMILY_OPENVMS
```
    See Also:
    
    Constant Field Values
  - OS_NAME
```
public static final String OS_NAME
```
  - OS_ARCH
```
public static final String OS_ARCH
```
  - OS_VERSION
```
public static final String OS_VERSION
```
  - OS_FAMILY
```
public static final String OS_FAMILY
```
- Constructor Detail
  - Os
```
public Os()
```
    Default constructor
  - Os
```
public Os(String family)
```
    Constructor that sets the family attribute
    
    Parameters:
    
    family - a String value
- Method Detail
  - setFamily
```
public void setFamily(String f)
```
    Sets the desired OS family type
    Parameters:
    f - The OS family type desired
    Possible values:
    
    dos
    
    mac
    
    netware
    
    os/2
    
    tandem
    
    unix
    
    windows
    
    win9x
    
    z/os
    
    os/400
    
    openvms
  - setName
```
public void setName(String name)
```
    Sets the desired OS name
    
    Parameters:
    
    name - The OS name
  - setArch
```
public void setArch(String arch)
```
    Sets the desired OS architecture
    
    Parameters:
    
    arch - The OS architecture
  - setVersion
```
public void setVersion(String version)
```
    Sets the desired OS version
    
    Parameters:
    
    version - The OS version
  - eval
```
public boolean eval()
             throws Exception
```
    Returns:
    
    Determines if the current OS matches the type of that set in setFamily.
    
    Throws:
    
    Exception - any errir
    
    See Also:
    
    setFamily(String)
  - isFamily
```
public static boolean isFamily(String family)
```
    Determines if the current OS matches the given OS family.
    
    Parameters:
    
    family - the family to check for
    
    Returns:
    
    true if the OS matches
    
    Since:
    
    1.0
  - isName
```
public static boolean isName(String name)
```
    Determines if the current OS matches the given OS name.
    
    Parameters:
    
    name - the OS name to check for
    
    Returns:
    
    true if the OS matches
    
    Since:
    
    1.0
  - isArch
```
public static boolean isArch(String arch)
```
    Determines if the current OS matches the given OS architecture.
    
    Parameters:
    
    arch - the OS architecture to check for
    
    Returns:
    
    true if the OS matches
    
    Since:
    
    1.0
  - isVersion
```
public static boolean isVersion(String version)
```
    Determines if the current OS matches the given OS version.
    
    Parameters:
    
    version - the OS version to check for
    
    Returns:
    
    true if the OS matches
    
    Since:
    
    1.0
  - isOs
```
public static boolean isOs(String family,
                           String name,
                           String arch,
                           String version)
```
    Determines if the current OS matches the given OS family, name, architecture and version. The name, architecture and version are compared to the System properties os.name, os.version and os.arch in a case-independent way.
    
    Parameters:
    
    family - The OS family
    
    name - The OS name
    
    arch - The OS architecture
    
    version - The OS version
    
    Returns:
    
    true if the OS matches
    
    Since:
    
    1.0
  - isValidFamily
```
public static boolean isValidFamily(String theFamily)
```
    Helper method to check if the given family is in the following list:
    - dos
    - mac
    - netware
    - os/2
    - tandem
    - unix
    - windows
    - win9x
    - z/os
    - os/400
    - openvms
    Parameters:
    
    theFamily - the family to check.
    
    Returns:
    
    true if one of the valid families.
    
    Since:
    
    1.4.2
  - getValidFamilies
```
public static Set<String> getValidFamilies()
```
    Returns:
    
    a copy of the valid families
    
    Since:
    
    1.4.2

Class Os

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

FAMILY_DOS

FAMILY_MAC

FAMILY_NETWARE

FAMILY_OS2

FAMILY_TANDEM

FAMILY_UNIX

FAMILY_WINDOWS

FAMILY_WIN9X

FAMILY_ZOS

FAMILY_OS400

FAMILY_OPENVMS

OS_NAME

OS_ARCH

OS_VERSION

OS_FAMILY

Constructor Detail

Os

Os

Method Detail

setFamily

setName

setArch

setVersion

eval

isFamily

isName

isArch

isVersion

isOs

isValidFamily

getValidFamilies