dax_zip_create_contig(3dax) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

dax_zip_create_contig(3dax)

DAX Library Functions                              dax_zip_create_contig(3DAX)



NAME
       dax_zip_create_contig - create a codec from contiguous symbols

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

       #include <dax.h>

       dax_status_t
       dax_zip_create_contig(dax_context_t *ctx, void *buf, size_t length,
           dax_zip_t **codec);

DESCRIPTION
       This  function  is an alternative to the dax_zip_create() function. But
       in this function, the nsyms, widths, and syms are passed in a  contigu‐
       ous  block of length bytes starting at buf. The returned codec uses buf
       by reference. buf must align on a 16 byte boundary.


       The buf block has the following format:


       tab(); lw(NaNi) lw(NaNi) lw(NaNi) lw(NaNi)  Byte  offsetContents  0  to
       1uint16_t  nsyms  2  to  ...uint8_t  widths[ ] ... to length - 1uint8_t
       syms[ ]



       Definitions  of  nsyms,  widths,  and  syms  are   available   in   the
       dax_zip_create(3DAX)  man  page.  The  size  of widths is ceil(nsyms/2)
       bytes. length must not exceed 4098 bytes for libdax version 1, or  8192
       bytes for libdax version 2.


       The  value  of length must be equal to 2 + ceil(nsyms/2) + sum(widths).
       The library only checks this condition  if  the  DAX_DEBUG_EXTRA  debug
       option  is  set.  If  the  condition  is  violated and not checked, the
       results are undefined.


       On successful return, the caller must not modify or free buf so long as
       the  returned codec is used in the DAX operations. If this condition is
       violated, the results are undefined.

RETURN VALUES
       DAX_SUCCESS    Operation completed successfully


       DAX_EINVAL     Invalid argument


       DAX_ENOMEM     Memory resources unavailable


       DAX_ETHREAD    The calling thread did not create ctx



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE VALUE _ Availabilitysystem/library _ Interface StabilityCommit‐
       ted


USAGE
       For best performance, align buf to  the  value  of  the  zip_align_best
       property as defined in the dax_get_props(3DAX) man page.

SEE ALSO
       dax_zip_create(3DAX), dax_zip_free(3DAX), dax_set_debug(3DAX)

NOTES
       libdax  version  2 passes buf directly to DAX, avoiding the overhead of
       converting the codec to a different internal format. libdax  version  1
       always converts buf to a different format.



Oracle Solaris 11.4               29 Aug 2017
                                                   dax_zip_create_contig(3DAX)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3