|
|
HP-UX Reference > Nnis_server(3N)HP-UX 11i Version 2: December 2007 Update |
|
NAMEnis_server(), nis_mkdir(), nis_rmdir(), nis_servstate(), nis_stats(), nis_getservlist(), nis_freeservlist(), nis_freetags() — miscellaneous NIS+ functions SYNOPSIScc [ flag... ] file... -lnsl [ library... ] #include <rpcsvc/nis.h> nis_error nis_mkdir(const nis_name dirname, const nis_server *machine); nis_error nis_rmdir(const nis_name dirname, const nis_server *machine); nis_error nis_servstate(const nis_server *machine, const nis_tag *tags, const int numtags, nis_tag **result); nis_error nis_stats(const nis_server *machine, const nis_tag *tags, const int numtags, nis_tag **result); void nis_freetags(nis_tag *tags, const int numtags); nis_server **nis_getservlist(const nis_name dirname); void nis_freeservlist(nis_server **machines); DESCRIPTIONThese functions provide a variety of services for NIS+ applications. nis_mkdir() is used to create the necessary databases to support NIS+ service for a directory, dirname, on a server, machine. If this operation is successful, it means that the directory object describing dirname has been updated to reflect that server machine is serving the named directory. For a description of the nis_server structure, refer to nis_objects(3N). nis_rmdir() is used to delete the directory, dirname, from the specified machine. The machine parameter cannot be NULL. For a description of the nis_server structure, refer to nis_objects(3N). nis_servstate() is used to set and read the various state variables of the NIS+ servers. In particular the internal debugging state of the servers may be set and queried. The nis_stats() function is used to retrieve statistics about how the server is operating. Tracking these statistics can help administrators determine when they need to add additional replicas or to break up a domain into two or more subdomains. For more information on reading statistics, see nisstat(1M). nis_servstate() and nis_stats() use the tag list. This tag list is a variable length array of nis_tag structures whose length is passed to the function in the numtags parameter. The set of legal tags are defined in the file <rpcsvc/nis_tags.h> which is included in <rpcsvc/nis.h>. Because these tags can and do vary between implementations of the NIS+ service, it is best to consult this file for the supported list. Passing unrecognized tags to a server will result in their tag_value member being set to the string ``unknown.'' Both of these functions return their results in malloced tag structure, *result. If there is an error, *result is set to NULL. The tag_value pointers points to allocated string memory which contains the results. Use nis_freetags() to free the tag structure. nis_getservlist() returns a null terminated list of nis_server structures that represent the list of servers that serve the domain named dirname. Servers from this list can be used when calling functions that require the name of a NIS+ server. For a description of the nis_server structure, refer to nis_objects(3N). nis_freeservlist() frees the list of servers returned by nis_getservlist(). Note that this is the only legal way to free that list. MULTITHREAD USAGE
These functions can be called safely in a multithreaded environment. These functions may be thread cancellation points because they invoke functions that are thread cancellation points. In a multithreaded environment, these functions are not safe to be called by a child process after fork() and before exec(). These functions should not be called by a multithreaded application that support asynchronous cancellation or asynchronous signals. |
|