PEAR Manual
Prev |  | Next

# File_SMBPasswd::addMachine()

File_SMBPasswd::addMachine() -- add a new maschine-account with the given plaintext-password.

## Synopsis

``mixed File_SMBPasswd::addMachine` (string $machine, int $userid [, string $comment = ''])`

## Description

This method works in the same way as File_SMBPasswd::addAccount() , except the flags are forced representing a machine-account, a $ is implicitely added to the machinename.

## Parameter

- `string $machine` - machinename to be added

- `int $userid` - userid of the user

- `string $comment` - comment

## Return value

`mixed` - Returns `TRUE` on success, PEAR_Error on failure.

## Note

This function can not be called statically.

Note that the machine to be added must already exist in the system password file.

## See

File_SMBPasswd::addAccount()
File_SMBPasswd::addUser()
File_SMBPasswd::addAccountEncrypted()

## Example

Example 38-1. Using File_SMBPasswd::addMachine()
    <?php
    require_once 'File/SMBPasswd.php';

    // add user mbretter
    $fh = new File_SMBPasswd('/usr/local/private/smbpasswd');
    $fh->load();
    $status = $fh->addMachine(
        'mypc',
        10004,
        'My Turbo PC');
    if (PEAR::isError($status)) {
        // handle errors
    } else {
        // continue processing
        $fh->save();
    }

    ?>

Prev | Home | Next
File_SMBPasswd::addUser() | Up | File_SMBPasswd::modAccountEncrypted()