goodpw_set_other_checks(S-osr5)

goodpw_set_other_checks -- select password parameters

Syntax

cc . . . -lprot

#include <sys/types.h>
#include <prot.h>

int goodpw_set_other_checks(type)
int type;

Description

goodpw_set_other_checks selects the password parameters for groups, modem lines, or filesystems, allowing passwords to be checked with goodpw_check_other(S-osr5).

This routine is called when checking the suitability of passwords for groups, modem lines and filesystems. type is either GOODPW_GROUP, GOODPW_MODEM or GOODPW_FILSYS depending on the object for which the password is intended. If goodpw(ADM) is configured, this routine will terminate any existing goodpw dialogue, and open a pipe to goodpw for subsequent repeated use by goodpw_check_other(S-osr5).

Return values

The following values are returned by goodpw_set_other_checks:

SMP_FAIL: No memory was available to store the goodpw parameters.
SMP_EXTFAIL: goodpw was configured, but the attempt to execute it failed.
SMP_COMPLETE: The checks have been successfully established.

Diagnostics

In the current implementation no diagnostic messages are returned.

Examples

See goodpw_check_other(S-osr5) for an example which illustrates the usage of goodpw_set_other_checks.

Files

/lib/libprot.a: security subsystem library routines
/usr/lib/libp/libprot.a: as above but used for profiling

Standards conformance

goodpw_set_other_checks is not part of any currently supported standard; it is an extension of AT&T System V provided by The Santa Cruz Operation, Inc.