NAME pm_tmpfile() – create a temporary unnamed file SYNOPSIS #include <netpbm/pm.h> FILE * pm_tmpfile(void); EXAMPLE This simple example creates a temporary file, writes ‘hello world’ to it, then reads back and prints those contents. #include <netpbm/pm.h> FILE *myfileP; myfile = pm_tmpfile(); fprintf(myfile, ‘hello world ‘); fseek(myfileP, 0, SEEK_SET); fread(buffer, sizeof(buffer), 1, myfileP); fprintf(STDOUT, ‘temp file…
NAME libtasn1_strerror – Returns a string with a description of an error SYNOPSIS #include <libtasn1.h> const char * libtasn1_strerror(asn1_retCode error); ARGUMENTS asn1_retCode error is an error returned by a libtasn1 function. DESCRIPTION This function is similar to strerror. The only difference is that it accepts an error (number) returned by a libtasn1 function. RETURNS Pointer…
NAME libtasn1_perror – prints a string to stderr with a description of an error SYNOPSIS #include <libtasn1.h> void libtasn1_perror(asn1_retCode error); ARGUMENTS asn1_retCode error is an error returned by a libtasn1 function. DESCRIPTION This function is like perror(). The only difference is that it accepts an error returned by a libtasn1 function. DEPRECATED Use asn1_perror() instead….
NAME libtalloc_tutorial – The Tutorial Introduction Talloc is a hierarchical, reference counted memory pool system with destructors. It is built atop the C standard library and it defines a set of utility functions that altogether simplifies allocation and deallocation of data, especially for complex structures that contain many dynamically allocated elements such as strings and…
NAME libtalloc_threads – Chapter 8: Using threads with talloc and thread safety The talloc library is not internally thread-safe, in that accesses to variables on a talloc context are not controlled by mutexes or other thread-safe primitives. However, so long as talloc_disable_null_tracking() is called from the main thread to disable global variable access within talloc,…
NAME libtalloc_stealing – Chapter 2: Stealing a context Stealing a context Talloc has the ability to change the parent of a talloc context to another one. This operation is commonly referred to as stealing and it is one of the most important actions performed with talloc contexts. Stealing a context is necessary if we want…
NAME libtalloc_pools – Chapter 5: Memory pools Memory pools Allocation of a new memory is an expensive operation and large programs can contain thousands of calls of malloc() for a single computation, where every call allocates only a very small amount of the memory. This can result in an undesirable slowdown of the application. We…
NAME libtalloc_dts – Chapter 3: Dynamic type system Dynamic type system Generic programming in the C language is very difficult. There is no inheritance nor templates known from object oriented languages. There is no dynamic type system. Therefore, generic programming in this language is usually done by type-casting a variable to void* and transferring it…
NAME libtalloc_destructors – Chapter 4: Using destructors Using destructors Destructors are well known methods in the world of object oriented programming. A destructor is a method of an object that is automatically run when the object is destroyed. It is usually used to return resources taken by the object back to the system (e.g. closing…
NAME libtalloc_debugging – Chapter 6: Debugging Although talloc makes memory management significantly easier than the C standard library, developers are still only humans and can make mistakes. Therefore, it can be handy to know some tools for the inspection of talloc memory usage. Talloc log and abort We have already encountered the abort function in…
NAME libtalloc_context – Chapter 1: Talloc context Talloc context The talloc context is the most important part of this library and is responsible for every single feature of this memory allocator. It is a logical unit which represents a memory space managed by talloc. From the programmer’s point of view, the talloc context is completely…
NAME libtalloc_bestpractices – Chapter 7: Best practises The following sections contain several best practices and good manners that were found by the Samba and SSSD developers over the years. These will help you to write code which is better, easier to debug and with as few (hopefully none) memory leaks as possible. Keep the context…
Name pm_system – run a Netpbm program with program input and output Synopsis #include <netpbm/pm_system.h> pm_system(void stdinFeeder(int, void *), void *const feederParm, void stdoutAccepter(int, void *), void *const accepterParm, const char *const shellCommand); pm_system_lp(const char *const progName, void stdinFeeder(int, void *), void *const feederParm, void stdoutAccepter(int, void *), void *const accepterParm, …); pm_system_vp(const char *const…
NAME libswscale – video scaling and pixel format conversion library DESCRIPTION The libswscale library performs highly optimized image scaling and colorspace and pixel format conversion operations. Specifically, this library performs the following conversions: • Rescaling: is the process of changing the video size. Several rescaling options and algorithms are available. This is usually a lossy…
NAME libswresample – audio resampling library DESCRIPTION The libswresample library performs highly optimized audio resampling, rematrixing and sample format conversion operations. Specifically, this library performs the following conversions: • Resampling: is the process of changing the audio rate, for example from a high sample rate of 44100Hz to 8000Hz. Audio conversion from high to low…
NAME libstorage – routines for managing INN storage SYNOPSIS #include <inn/storage.h> typedef enum { RETR_ALL, RETR_HEAD, RETR_BODY, RETR_STAT } RETRTYPE; typedef enum { SM_RDWR, SM_PREOPEN } SMSETUP; typedef unsigned char STORAGECLASS; typedef unsigned char STORAGETYPE; typedef struct token { STORAGETYPE type; STORAGECLASS class; char token[STORAGE_TOKEN_LENGTH]; } TOKEN; typedef struct { unsigned char type; const char…
NAME statgrab, libstatgrab – get system statistics SYNOPSIS #include <statgrab.h> sg_error sg_init (int ignore_init_errors); sg_error sg_shutdown (void); sg_error sg_drop_privileges (void); sg_error sg_get_error (void); const char *sg_get_error_arg (void); int sg_get_error_errno (void); const char *sg_str_error (sg_error code); sg_error sg_get_error_details (sg_error_details *err_details); char *sg_strperror (char **buf, const sg_error_details * const err_details); size_t sg_get_nelements (const void *data); sg_error sg_free_stats_buf…
NAME libssh2_version – return the libssh2 version number SYNOPSIS #include <libssh2.h> const char * libssh2_version(int required_version); DESCRIPTION If required_version is lower than or equal to the version number of the libssh2 in use, the version number of libssh2 is returned as a pointer to a zero terminated string. The required_version should be the version number…
NAME libssh2_userauth_publickey_fromfile – authenticate a session with a public key, read from a file SYNOPSIS #include <libssh2.h> int libssh2_userauth_publickey_fromfile_ex(LIBSSH2_SESSION *session, const char *username, const char *publickey, const char *privatekey, const char *passphrase); DESCRIPTION session – Session instance as returned by libssh2_session_init_ex(3) username – Pointer to user name to authenticate as. username_len – Length of username….
NAME libssh2_userauth_publickey_fromfile – convenience macro for libssh2_userauth_publickey_fromfile_ex(3) calls SYNOPSIS #include <libssh2.h> int libssh2_userauth_publickey_fromfile(LIBSSH2_SESSION *session, const char *username, const char *publickey, const char *privatekey, const char *passphrase); DESCRIPTION This is a macro defined in a public libssh2 header file that is using the underlying function libssh2_userauth_publickey_fromfile_ex(3). RETURN VALUE See libssh2_userauth_publickey_fromfile_ex(3) ERRORS See libssh2_userauth_publickey_fromfile_ex(3) SEE ALSO libssh2_userauth_publickey_fromfile_ex(3) Index