HP-UX Reference (11i v1 00/12) - 3 Library Functions N-Z (vol 7)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man3/nan.3m

________________________________________________________________

___ ___

nis_objects(3N) nis_objects(3N)

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.