ldap_init_searchprefs_buf man page on SunOS

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
SunOS logo
[printable version]

ldap_searchprefs(3LDAP)	    LDAP Library Functions     ldap_searchprefs(3LDAP)

NAME
       ldap_searchprefs,   ldap_init_searchprefs,   ldap_init_searchprefs_buf,
       ldap_free_searchprefs, ldap_first_searchobj, ldap_next_searchobj - LDAP
       search preference configuration routeines

SYNOPSIS
       cc[ flag... ] file... -lldap[ library... ]

       # include <lber.h>
       # include <ldap.h>

       int    ldap_init_searchprefs(char    **file,    struct	ldap_searchobj
       ***solistp);

       int  ldap_init_searchprefs_buf(char  **buf,  unsigned  longlen,	struct
       ldap_searchobj **solistp);

       struct	ldap_searchobj	**ldap_free_searchprefs(struct	ldap_searchobj
       **solist);

       struct	ldap_searchobj	 **ldap_first_searchobj(struct	 ldap_seachobj
       **solist);

       struct	 ldap_searchobj	  **ldap_next_searchobj(struct	 ldap_seachobj
       **solist, struct ldap_seachobj **so);

DESCRIPTION
       These functions provide a standard way to access LDAP search preference
       configuration  data.   LDAP  search preference configurations are typi‐
       cally used by LDAP client programs to specify which attributes  a  user
       may  search  by, labels for the attributes, and LDAP filters and scopes
       associated with those searches.	Client software presents these choices
       to a user, who can then specify the type of search to be performed.

       ldap_init_searchprefs()	reads a sequence of search preference configu‐
       rations	from  a	 valid	LDAP   searchpref  configuration   file.   See
       ldapsearchprefs.conf(4). Upon success, 0 is returned and solistp is set
       to point to a list of search preference data structures.

       ldap_init_searchprefs_buf() reads a sequence of search preference  con‐
       figurations  from  buf,	whose  size is buflen. buf should point to the
       data in the format defined for an LDAP search preference	 configuration
       file.  See   ldapsearchprefs.conf(4).  Upon  success, 0 is returned and
       solistp is set to point to a list of search preference data structures.

       ldap_free_searchprefs() disposes of the data  structures	 allocated  by
       ldap_init_searchprefs().

       ldap_first_searchpref() returns the first search preference data struc‐
       ture in the list solist. The solist is typically	 obtained  by  calling
       ldap_init_searchprefs().

       ldap_next_searchpref()  returns	the  search preference after so in the
       template list solist. A NULL pointer is returned	 if  so	 is  the  last
       entry in the list.

ERRORS
       ldap_init_search_prefs() and ldap_init_search_prefs_bufs() return:

       LDAP_SEARCHPREF_ERR_VERSION     **buf points to data that is newer than
				       can be handled.

       LDAP_SEARCHPREF_ERR_MEM	       Memory allocation problem.

ATTRIBUTES
       See attributes(5) for a description of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       │Availability		     │SUNWcsl (32-bit)		   │
       │			     │SUNWcslx (64-bit)		   │
       │Interface Stability	     │Evolving			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       ldap(3LDAP), ldapsearchprefs.conf(4), attributes(5)

       Yeong, W., Howes, T., and Hardcastle-Kille, S., "Lightweight  Directory
       Access Protocol", OSI-DS-26, April 1992.

       Howes,  T.,  Hardcastle-Kille,  S., Yeong, W., and Robbins, C., "Light‐
       weight Directory Access Protocol", OSI-DS-26, April 1992.

       Hardcastle-Kille, S., "A String Representation of Distinguished Names",
       OSI-DS-23, April 1992.

       Information  Processing - Open Systems Interconnection - The Directory,
       International Organization for Standardization.	International Standard
       9594, (1988).

SunOS 5.10			  27 Jan 2002	       ldap_searchprefs(3LDAP)
[top]

List of man pages available for SunOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net