HP-UX Reference (11i v2 03/08) - 3 Library Functions N-Z (vol 7)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

nis_objects(3N) nis_objects(3N)

The TA_SEARCHABLE

ﬂag speciﬁes that values in this column can be searched. Searchable columns

must contain textual data and must have a name associated with them. The ﬂag

TA_CASE speciﬁes that

searches involving this column ignore the case of the value in the column. At least one of the columns in

the table should be searchable. Also, the combination of all searchable column values should uniquely

select an entry within the table.

Entry Objects

Entry objects are stored in tables. The structure used to deﬁne the entry data is as follows.

#define EN_BINARY 1

#define EN_CRYPT 2

#define EN_XDR 4

#define EN_MODIFIED 8

struct entry_col {

u_long ec_flags;

struct {

u_int ec_value_len;

char *ec_value_val;

} ec_value;

}

typedef struct entry_col entry_col;

struct entry_obj {

char *en_type;

struct {

u_int en_cols_len;

entry_col *en_cols_val;

} en_cols;

}

The en_type member contains a string that speciﬁes the type of data this entry represents. The NIS+

server will compare this string to the type string speciﬁed in the table object and disallow any updates or

modiﬁcations if they differ.

The en_cols structure contains two members: en_cols_len and en_cols_val . en_cols_val is an

array of entry_col structures. en_cols_len contains a count of the number of cells in the

en_cols_val array and reﬂects the number of columns in the table -- it always contains the same value

as the table_obj.ta_cols.ta_cols_len member from the table which contains the entry.

The entry_col structure contains information about the entry’s per-column values. ec_value contains

information about a particular value. It has two members: ec_value_val , which is the value itself, and

ec_value_len , which is the length (in bytes) of the value. entry_col also contains the member

ec_flags, which contains a set of ﬂags for the entry.

The ﬂags in ec_flags are primarily used when adding or modifying entries in a table. All columns that

have the ﬂag

EN_CRYPT set will be encrypted prior to sending them over the network. Columns with

EN_BINARY set are presumed to contain binary data. The server will ensure that the column in the

table object speciﬁes binary data prior to allowing the entry to be added. When modifying entries in a

table, only those columns that have changed need be sent to the server. Those columns should each have

the EN_MODIFIED ﬂag set to indicate this to the server.

WARNINGS

HP-UX 11i Version 2 is the last HP-UX release on which NIS+ is supported.

LDAP is the recommended replacement for NIS+. HP fully supports the industry standard naming ser-

vices based on LDAP.