Manual Pages for UNIX Operating System command usage for man SLPUnescape

Service Location Protocol Library Functions     SLPUnescape(3SLP)



NAME
     SLPUnescape - translate escaped characters into UTF-8

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

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


DESCRIPTION
     The SLPUnescape() function processes  the  input  string  in
     pcInbuf  and  unescapes any SLP reserved characters.  If the
     isTag parameter is SLPTrue, then look for bad tag characters
     and   signal   an   error   if   any   are  found  with  the
     SLP_PARSE_ERROR code.  No transformation is performed if the
     input  string  is  an  opaque.   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. Must be
                  freed using SLPFree(3SLP) when the memory is no
                  longer needed.


     isTag        When true, the input buffer is checked 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 Using SLPUnescape()


     The  following  example  decodes  the   representation   for
     ",tag,":


       char* pcOutBuf;
       SLPError err;




SunOS 5.11          Last change: 16 Jan 2003                    1






Service Location Protocol Library Functions     SLPUnescape(3SLP)



       err = SLPUnescape("\2c tag\2c", &pcOutbuf, SLP_TRUE);


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),SLPFree(3SLP),     slp_api(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