diff options
author | Daniel Buch <boogiewasthere@gmail.com> | 2014-01-14 11:46:49 +0100 |
---|---|---|
committer | Tom Gundersen <teg@jklm.no> | 2014-01-14 13:32:13 +0100 |
commit | 12f404c4d1dc31a54013646473249b4644fc23e7 (patch) | |
tree | c9c2c15c8273b2e99fd13c577afe618eddb6f559 /src/systemd | |
parent | 2a4be8ad9896ebd02d0d92be1a116aabd2bf402b (diff) |
sd-resolv: rename old asyncns variables
Diffstat (limited to 'src/systemd')
-rw-r--r-- | src/systemd/sd-resolv.h | 48 |
1 files changed, 24 insertions, 24 deletions
diff --git a/src/systemd/sd-resolv.h b/src/systemd/sd-resolv.h index c9f1d1d91c..21e2413542 100644 --- a/src/systemd/sd-resolv.h +++ b/src/systemd/sd-resolv.h @@ -33,48 +33,48 @@ _SD_BEGIN_DECLARATIONS; * * \section moo Method of operation * - * To use libasyncns allocate an sd_resolv_t object with + * To use libresolv allocate an sd_resolv_t object with * sd_resolv_new(). This will spawn a number of worker threads (or processes, depending on what is available) which * are subsequently used to process the queries the controlling * program issues via sd_resolv_getaddrinfo() and * sd_resolv_getnameinfo(). Use sd_resolv_free() to shut down the worker * threads/processes. * - * Since libasyncns may fork off new processes you have to make sure that + * Since libresolv may fork off new processes you have to make sure that * your program is not irritated by spurious SIGCHLD signals. */ -/** An opaque libasyncns session structure */ +/** An opaque libresolv session structure */ typedef struct sd_resolv sd_resolv_t; -/** An opaque libasyncns query structure */ +/** An opaque libresolv query structure */ typedef struct sd_resolv_query sd_resolv_query_t; -/** Allocate a new libasyncns session with n_proc worker processes/threads */ +/** Allocate a new libresolv session with n_proc worker processes/threads */ sd_resolv_t* sd_resolv_new(unsigned n_proc); -/** Free a libasyncns session. This destroys all attached +/** Free a libresolv session. This destroys all attached * sd_resolv_query_t objects automatically */ -void sd_resolv_free(sd_resolv_t *asyncns); +void sd_resolv_free(sd_resolv_t *resolv); /** Return the UNIX file descriptor to select() for readability - * on. Use this function to integrate libasyncns with your custom main + * on. Use this function to integrate libresolv with your custom main * loop. */ -int sd_resolv_fd(sd_resolv_t *asyncns); +int sd_resolv_fd(sd_resolv_t *resolv); /** Process pending responses. After this function is called you can * get the next completed query object(s) using sd_resolv_getnext(). If * block is non-zero wait until at least one response has been * processed. If block is zero, process all pending responses and * return. */ -int sd_resolv_wait(sd_resolv_t *asyncns, int block); +int sd_resolv_wait(sd_resolv_t *resolv, int block); /** Issue a name to address query on the specified session. The * arguments are compatible with the ones of libc's * getaddrinfo(3). The function returns a new query object. When the * query is completed you may retrieve the results using * sd_resolv_getaddrinfo_done().*/ -sd_resolv_query_t* sd_resolv_getaddrinfo(sd_resolv_t *asyncns, const char *node, const char *service, const struct addrinfo *hints); +sd_resolv_query_t* sd_resolv_getaddrinfo(sd_resolv_t *resolv, const char *node, const char *service, const struct addrinfo *hints); /** Retrieve the results of a preceding sd_resolv_getaddrinfo() * call. Returns a addrinfo structure and a return value compatible @@ -83,7 +83,7 @@ sd_resolv_query_t* sd_resolv_getaddrinfo(sd_resolv_t *asyncns, const char *node, * returned addrinfo structure with sd_resolv_freeaddrinfo() and not * libc's freeaddrinfo(3)! If the query is not completed yet EAI_AGAIN * is returned.*/ -int sd_resolv_getaddrinfo_done(sd_resolv_t *asyncns, sd_resolv_query_t* q, struct addrinfo **ret_res); +int sd_resolv_getaddrinfo_done(sd_resolv_t *resolv, sd_resolv_query_t* q, struct addrinfo **ret_res); /** Issue an address to name query on the specified session. The * arguments are compatible with the ones of libc's @@ -91,48 +91,48 @@ int sd_resolv_getaddrinfo_done(sd_resolv_t *asyncns, sd_resolv_query_t* q, struc * query is completed you may retrieve the results using * sd_resolv_getnameinfo_done(). Set gethost (resp. getserv) to non-zero * if you want to query the hostname (resp. the service name). */ -sd_resolv_query_t* sd_resolv_getnameinfo(sd_resolv_t *asyncns, const struct sockaddr *sa, socklen_t salen, int flags, int gethost, int getserv); +sd_resolv_query_t* sd_resolv_getnameinfo(sd_resolv_t *resolv, const struct sockaddr *sa, socklen_t salen, int flags, int gethost, int getserv); /** Retrieve the results of a preceding sd_resolv_getnameinfo() * call. Returns the hostname and the service name in ret_host and * ret_serv. The query object q is destroyed by this call and may not * be used any further. If the query is not completed yet EAI_AGAIN is * returned. */ -int sd_resolv_getnameinfo_done(sd_resolv_t *asyncns, sd_resolv_query_t* q, char *ret_host, size_t hostlen, char *ret_serv, size_t servlen); +int sd_resolv_getnameinfo_done(sd_resolv_t *resolv, sd_resolv_query_t* q, char *ret_host, size_t hostlen, char *ret_serv, size_t servlen); /** Issue a resolver query on the specified session. The arguments are * compatible with the ones of libc's res_query(3). The function returns a new * query object. When the query is completed you may retrieve the results using * sd_resolv_res_done(). */ -sd_resolv_query_t* sd_resolv_res_query(sd_resolv_t *asyncns, const char *dname, int class, int type); +sd_resolv_query_t* sd_resolv_res_query(sd_resolv_t *resolv, const char *dname, int class, int type); /** Issue an resolver query on the specified session. The arguments are * compatible with the ones of libc's res_search(3). The function returns a new * query object. When the query is completed you may retrieve the results using * sd_resolv_res_done(). */ -sd_resolv_query_t* sd_resolv_res_search(sd_resolv_t *asyncns, const char *dname, int class, int type); +sd_resolv_query_t* sd_resolv_res_search(sd_resolv_t *resolv, const char *dname, int class, int type); /** Retrieve the results of a preceding sd_resolv_res_query() or - * asyncns_res_search call. The query object q is destroyed by this + * resolv_res_search call. The query object q is destroyed by this * call and may not be used any further. Returns a pointer to the * answer of the res_query call. If the query is not completed yet * -EAGAIN is returned, on failure -errno is returned, otherwise the * length of answer is returned. Make sure to free the answer is a * call to sd_resolv_freeanswer(). */ -int sd_resolv_res_done(sd_resolv_t *asyncns, sd_resolv_query_t* q, unsigned char **answer); +int sd_resolv_res_done(sd_resolv_t *resolv, sd_resolv_query_t* q, unsigned char **answer); /** Return the next completed query object. If no query has been * completed yet, return NULL. Please note that you need to run * sd_resolv_wait() before this function will return sensible data. */ -sd_resolv_query_t* sd_resolv_getnext(sd_resolv_t *asyncns); +sd_resolv_query_t* sd_resolv_getnext(sd_resolv_t *resolv); /** Return the number of query objects (completed or not) attached to * this session */ -int sd_resolv_getnqueries(sd_resolv_t *asyncns); +int sd_resolv_getnqueries(sd_resolv_t *resolv); /** Cancel a currently running query. q is is destroyed by this call * and may not be used any futher. */ -void sd_resolv_cancel(sd_resolv_t *asyncns, sd_resolv_query_t* q); +void sd_resolv_cancel(sd_resolv_t *resolv, sd_resolv_query_t* q); /** Free the addrinfo structure as returned by * sd_resolv_getaddrinfo_done(). Make sure to use this functions instead @@ -143,15 +143,15 @@ void sd_resolv_freeaddrinfo(struct addrinfo *ai); void sd_resolv_freeanswer(unsigned char *answer); /** Returns non-zero when the query operation specified by q has been completed */ -int sd_resolv_isdone(sd_resolv_t *asyncns, sd_resolv_query_t*q); +int sd_resolv_isdone(sd_resolv_t *resolv, sd_resolv_query_t*q); /** Assign some opaque userdata with a query object */ -void sd_resolv_setuserdata(sd_resolv_t *asyncns, sd_resolv_query_t *q, void *userdata); +void sd_resolv_setuserdata(sd_resolv_t *resolv, sd_resolv_query_t *q, void *userdata); /** Return userdata assigned to a query object. Use * sd_resolv_setuserdata() to set this data. If no data has been set * prior to this call it returns NULL. */ -void* sd_resolv_getuserdata(sd_resolv_t *asyncns, sd_resolv_query_t *q); +void* sd_resolv_getuserdata(sd_resolv_t *resolv, sd_resolv_query_t *q); _SD_END_DECLARATIONS; |