Manual Pages for UNIX Operating System command usage for man SLPEscape

Service Location Protocol Library Functions       SLPEscape(3SLP)



NAME
     SLPEscape - escapes SLP reserved characters

SYNOPSIS
     cc [ flag... ] file... -lslp [ library... ]
     #include 

     SLPError SLPEscape(const char *pcInBuf, char** ppcOutBuf,
          SLPBoolean isTag);


DESCRIPTION
     The SLPEscape() function processes the input string in pcIn-
     buf  and  escapes any SLP reserved characters.  If the isTag
     parameter is SLPTrue, it then looks for bad  tag  characters
     and  signals  an  error  if  any  are found by returning the
     SLP_PARSE_ERROR code.  The results are  put  into  a  buffer
     allocated  by  the API library and returned in the ppcOutBuf
     parameter.  This  buffer   should   be   deallocated   using
     SLPFree(3SLP) when the memory is no longer needed.

PARAMETERS
     pcInBuf      Pointer to the  input  buffer  to  process  for
                  escape characters.


     ppcOutBuf    Pointer to a pointer for the output buffer with
                  the SLP reserved characters escaped. It must be
                  freed using SLPFree() when  the  memory  is  no
                  longer needed.


     isTag        When true, checks the input buffer for bad  tag
                  characters.


ERRORS
     This function or its callback may return any SLP error code.
     See the ERRORS section in slp_api(3SLP).

EXAMPLES
     Example 1 Converting Attribute Tags


     The following example shows how to convert the attribute tag
     ,tag-example, to on the wire format:


       SLPError err;
       char* escaped Chars;

       err = SLPEscape(",tag-example,", &escapedChars, SLP_TRUE);



SunOS 5.11          Last change: 16 Jan 2003                    1






Service Location Protocol Library Functions       SLPEscape(3SLP)



ENVIRONMENT VARIABLES
     SLP_CONF_FILE    When set, use this file for configuration.


ATTRIBUTES
     See attributes(5)  for descriptions of the following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | service/network/slp         |
    |_____________________________|_____________________________|


SEE ALSO
     slpd(1M),   slp_api(3SLP),    SLPFree(3SLP),    slp.conf(4),
     slpd.reg(4), attributes(5)


     System Administration Guide: Network Services


     Guttman, E.,  Perkins, C., Veizades, J.,  and  Day,  M.  RFC
     2608,  Service  Location  Protocol,  Version 2. The Internet
     Society. June 1999.


     Kempf, J. and Guttman, E. RFC 2614, An API for Service Loca-
     tion. The Internet Society. June 1999.























SunOS 5.11          Last change: 16 Jan 2003                    2