2 Copyright (C) 2010 by Ronnie Sahlberg <ronniesahlberg@gmail.com>
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU Lesser General Public License as published by
6 the Free Software Foundation; either version 2.1 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU Lesser General Public License for more details.
14 You should have received a copy of the GNU Lesser General Public License
15 along with this program; if not, see <http://www.gnu.org/licenses/>.
18 * This is the highlevel interface to access NFS resources using a posix-like interface
28 #define EXTERN __declspec( dllexport )
57 * Used for interfacing the async version of the api into an external eventsystem
59 EXTERN
int nfs_get_fd(struct nfs_context
*nfs
);
60 EXTERN
int nfs_which_events(struct nfs_context
*nfs
);
61 EXTERN
int nfs_service(struct nfs_context
*nfs
, int revents
);
62 EXTERN
int nfs_queue_length(struct nfs_context
*nfs
);
65 * Used if you need different credentials than the default for the current user.
67 EXTERN
void nfs_set_auth(struct nfs_context
*nfs
, AUTH
*auth
);
71 * When an operation failed, this function can extract a detailed error string.
73 EXTERN
char *nfs_get_error(struct nfs_context
*nfs
);
77 * Callback for all ASYNC nfs functions
79 typedef void (*nfs_cb
)(int err
, struct nfs_context
*nfs
, void *data
, void *private_data
);
82 * Callback for all ASYNC rpc functions
84 typedef void (*rpc_cb
)(struct rpc_context
*rpc
, int status
, void *data
, void *private_data
);
92 * Create an NFS c, the context.
94 * NULL : Failed to create a context.
95 * *nfs : A pointer to an nfs context.
97 EXTERN
struct nfs_context
*nfs_init_context(void);
99 * Destroy an nfs context.
101 EXTERN
void nfs_destroy_context(struct nfs_context
*nfs
);
107 * Get the maximum supported READ3 size by the server
109 EXTERN
size_t nfs_get_readmax(struct nfs_context
*nfs
);
112 * Get the maximum supported WRITE3 size by the server
114 EXTERN
size_t nfs_get_writemax(struct nfs_context
*nfs
);
123 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
124 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
126 * When the callback is invoked, status indicates the result:
129 * -errno : An error occured.
130 * data is the error string.
132 EXTERN
int nfs_mount_async(struct nfs_context
*nfs
, const char *server
, const char *exportname
, nfs_cb cb
, void *private_data
);
136 * 0 : The operation was successfull.
137 * -errno : The command failed.
139 EXTERN
int nfs_mount(struct nfs_context
*nfs
, const char *server
, const char *exportname
);
148 * Async stat(<filename>)
150 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
151 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
153 * When the callback is invoked, status indicates the result:
155 * data is struct stat *
156 * -errno : An error occured.
157 * data is the error string.
160 EXTERN
int nfs_stat_async(struct nfs_context
*nfs
, const char *path
, nfs_cb cb
, void *private_data
);
162 * Sync stat(<filename>)
164 * 0 : The operation was successfull.
165 * -errno : The command failed.
167 EXTERN
int nfs_stat(struct nfs_context
*nfs
, const char *path
, struct stat
*st
);
174 * Async fstat(nfsfh *)
176 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
177 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
179 * When the callback is invoked, status indicates the result:
181 * data is struct stat *
182 * -errno : An error occured.
183 * data is the error string.
185 EXTERN
int nfs_fstat_async(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, nfs_cb cb
, void *private_data
);
187 * Sync fstat(nfsfh *)
189 * 0 : The operation was successfull.
190 * -errno : The command failed.
192 EXTERN
int nfs_fstat(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, struct stat
*st
);
200 * Async open(<filename>)
202 * mode is a combination of the flags : O_RDOLNY, O_WRONLY, O_RDWR , O_SYNC
205 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
206 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
208 * When the callback is invoked, status indicates the result:
210 * data is a struct *nfsfh;
211 * The nfsfh is close using nfs_close().
212 * -errno : An error occured.
213 * data is the error string.
215 EXTERN
int nfs_open_async(struct nfs_context
*nfs
, const char *path
, int mode
, nfs_cb cb
, void *private_data
);
217 * Sync stat(<filename>)
219 * 0 : The operation was successfull. *nfsfh is filled in.
220 * -errno : The command failed.
222 EXTERN
int nfs_open(struct nfs_context
*nfs
, const char *path
, int mode
, struct nfsfh
**nfsfh
);
234 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
235 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
237 * When the callback is invoked, status indicates the result:
240 * -errno : An error occured.
241 * data is the error string.
243 EXTERN
int nfs_close_async(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, nfs_cb cb
, void *private_data
);
247 * 0 : The operation was successfull.
248 * -errno : The command failed.
250 EXTERN
int nfs_close(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
);
260 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
261 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
263 * When the callback is invoked, status indicates the result:
265 * status is numer of bytes read.
266 * data is a pointer to the returned data.
267 * -errno : An error occured.
268 * data is the error string.
270 EXTERN
int nfs_pread_async(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, off_t offset
, size_t count
, nfs_cb cb
, void *private_data
);
274 * >=0 : numer of bytes read.
275 * -errno : An error occured.
277 EXTERN
int nfs_pread(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, off_t offset
, size_t count
, char *buf
);
288 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
289 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
291 * When the callback is invoked, status indicates the result:
293 * status is numer of bytes read.
294 * data is a pointer to the returned data.
295 * -errno : An error occured.
296 * data is the error string.
298 EXTERN
int nfs_read_async(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, size_t count
, nfs_cb cb
, void *private_data
);
302 * >=0 : numer of bytes read.
303 * -errno : An error occured.
305 EXTERN
int nfs_read(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, size_t count
, char *buf
);
317 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
318 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
320 * When the callback is invoked, status indicates the result:
322 * status is numer of bytes written.
323 * -errno : An error occured.
324 * data is the error string.
326 EXTERN
int nfs_pwrite_async(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, off_t offset
, size_t count
, char *buf
, nfs_cb cb
, void *private_data
);
330 * >=0 : numer of bytes written.
331 * -errno : An error occured.
333 EXTERN
int nfs_pwrite(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, off_t offset
, size_t count
, char *buf
);
343 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
344 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
346 * When the callback is invoked, status indicates the result:
348 * status is numer of bytes written.
349 * -errno : An error occured.
350 * data is the error string.
352 EXTERN
int nfs_write_async(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, size_t count
, char *buf
, nfs_cb cb
, void *private_data
);
356 * >=0 : numer of bytes written.
357 * -errno : An error occured.
359 EXTERN
int nfs_write(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, size_t count
, char *buf
);
369 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
370 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
372 * When the callback is invoked, status indicates the result:
374 * data is off_t * for the current position.
375 * -errno : An error occured.
376 * data is the error string.
378 EXTERN
int nfs_lseek_async(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, off_t offset
, int whence
, nfs_cb cb
, void *private_data
);
382 * >=0 : numer of bytes read.
383 * -errno : An error occured.
385 EXTERN
int nfs_lseek(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, off_t offset
, int whence
, off_t
*current_offset
);
395 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
396 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
398 * When the callback is invoked, status indicates the result:
400 * -errno : An error occured.
401 * data is the error string.
403 EXTERN
int nfs_fsync_async(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, nfs_cb cb
, void *private_data
);
408 * -errno : An error occured.
410 EXTERN
int nfs_fsync(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
);
421 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
422 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
424 * When the callback is invoked, status indicates the result:
426 * -errno : An error occured.
427 * data is the error string.
429 EXTERN
int nfs_truncate_async(struct nfs_context
*nfs
, const char *path
, off_t length
, nfs_cb cb
, void *private_data
);
434 * -errno : An error occured.
436 EXTERN
int nfs_truncate(struct nfs_context
*nfs
, const char *path
, off_t length
);
447 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
448 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
450 * When the callback is invoked, status indicates the result:
452 * -errno : An error occured.
453 * data is the error string.
455 EXTERN
int nfs_ftruncate_async(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, off_t length
, nfs_cb cb
, void *private_data
);
460 * -errno : An error occured.
462 EXTERN
int nfs_ftruncate(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, off_t length
);
476 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
477 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
479 * When the callback is invoked, status indicates the result:
481 * -errno : An error occured.
482 * data is the error string.
484 EXTERN
int nfs_mkdir_async(struct nfs_context
*nfs
, const char *path
, nfs_cb cb
, void *private_data
);
489 * -errno : An error occured.
491 EXTERN
int nfs_mkdir(struct nfs_context
*nfs
, const char *path
);
502 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
503 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
505 * When the callback is invoked, status indicates the result:
507 * -errno : An error occured.
508 * data is the error string.
510 EXTERN
int nfs_rmdir_async(struct nfs_context
*nfs
, const char *path
, nfs_cb cb
, void *private_data
);
515 * -errno : An error occured.
517 EXTERN
int nfs_rmdir(struct nfs_context
*nfs
, const char *path
);
529 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
530 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
532 * When the callback is invoked, status indicates the result:
534 * data is a struct *nfsfh;
535 * -errno : An error occured.
536 * data is the error string.
538 EXTERN
int nfs_creat_async(struct nfs_context
*nfs
, const char *path
, int mode
, nfs_cb cb
, void *private_data
);
543 * -errno : An error occured.
545 EXTERN
int nfs_creat(struct nfs_context
*nfs
, const char *path
, int mode
, struct nfsfh
**nfsfh
);
558 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
559 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
561 * When the callback is invoked, status indicates the result:
564 * -errno : An error occured.
565 * data is the error string.
567 EXTERN
int nfs_unlink_async(struct nfs_context
*nfs
, const char *path
, nfs_cb cb
, void *private_data
);
572 * -errno : An error occured.
574 EXTERN
int nfs_unlink(struct nfs_context
*nfs
, const char *path
);
587 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
588 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
590 * When struct nfsdir * is returned, this resource is closed/freed by calling nfs_closedir()
592 * When the callback is invoked, status indicates the result:
594 * data is struct nfsdir *
595 * -errno : An error occured.
596 * data is the error string.
598 EXTERN
int nfs_opendir_async(struct nfs_context
*nfs
, const char *path
, nfs_cb cb
, void *private_data
);
603 * -errno : An error occured.
605 EXTERN
int nfs_opendir(struct nfs_context
*nfs
, const char *path
, struct nfsdir
**nfsdir
);
613 struct nfsdirent
*next
;
617 /* some extra fields we get for free through the READDIRPLUS3 call. You need libnfs-raw-nfs.h for these */
618 uint32_t type
; /* NF3REG, NF3DIR, NF3BLK, ... */
621 struct timeval atime
;
622 struct timeval mtime
;
623 struct timeval ctime
;
626 * nfs_readdir() never blocks, so no special sync/async versions are available
628 EXTERN
struct nfsdirent
*nfs_readdir(struct nfs_context
*nfs
, struct nfsdir
*nfsdir
);
636 * nfs_closedir() never blocks, so no special sync/async versions are available
638 EXTERN
void nfs_closedir(struct nfs_context
*nfs
, struct nfsdir
*nfsdir
);
646 * Async statvfs(<dirname>)
648 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
649 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
651 * When the callback is invoked, status indicates the result:
653 * data is struct statvfs *
654 * -errno : An error occured.
655 * data is the error string.
658 EXTERN
int nfs_statvfs_async(struct nfs_context
*nfs
, const char *path
, nfs_cb cb
, void *private_data
);
660 * Sync statvfs(<dirname>)
662 * 0 : The operation was successfull.
663 * -errno : The command failed.
665 EXTERN
int nfs_statvfs(struct nfs_context
*nfs
, const char *path
, struct statvfs
*svfs
);
672 * Async readlink(<name>)
674 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
675 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
677 * When the callback is invoked, status indicates the result:
680 * data is only valid during the callback and is automatically freed when the callback returns.
681 * -errno : An error occured.
682 * data is the error string.
685 EXTERN
int nfs_readlink_async(struct nfs_context
*nfs
, const char *path
, nfs_cb cb
, void *private_data
);
687 * Sync readlink(<name>)
689 * 0 : The operation was successfull.
690 * -errno : The command failed.
692 EXTERN
int nfs_readlink(struct nfs_context
*nfs
, const char *path
, char *buf
, int bufsize
);
700 * Async chmod(<name>)
702 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
703 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
705 * When the callback is invoked, status indicates the result:
708 * -errno : An error occured.
709 * data is the error string.
711 EXTERN
int nfs_chmod_async(struct nfs_context
*nfs
, const char *path
, int mode
, nfs_cb cb
, void *private_data
);
715 * 0 : The operation was successfull.
716 * -errno : The command failed.
718 EXTERN
int nfs_chmod(struct nfs_context
*nfs
, const char *path
, int mode
);
726 * Async fchmod(<handle>)
728 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
729 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
731 * When the callback is invoked, status indicates the result:
734 * -errno : An error occured.
735 * data is the error string.
737 EXTERN
int nfs_fchmod_async(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, int mode
, nfs_cb cb
, void *private_data
);
739 * Sync fchmod(<handle>)
741 * 0 : The operation was successfull.
742 * -errno : The command failed.
744 EXTERN
int nfs_fchmod(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, int mode
);
752 * Async chown(<name>)
754 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
755 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
757 * When the callback is invoked, status indicates the result:
760 * -errno : An error occured.
761 * data is the error string.
763 EXTERN
int nfs_chown_async(struct nfs_context
*nfs
, const char *path
, int uid
, int gid
, nfs_cb cb
, void *private_data
);
767 * 0 : The operation was successfull.
768 * -errno : The command failed.
770 EXTERN
int nfs_chown(struct nfs_context
*nfs
, const char *path
, int uid
, int gid
);
778 * Async fchown(<handle>)
780 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
781 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
783 * When the callback is invoked, status indicates the result:
786 * -errno : An error occured.
787 * data is the error string.
789 EXTERN
int nfs_fchown_async(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, int uid
, int gid
, nfs_cb cb
, void *private_data
);
791 * Sync fchown(<handle>)
793 * 0 : The operation was successfull.
794 * -errno : The command failed.
796 EXTERN
int nfs_fchown(struct nfs_context
*nfs
, struct nfsfh
*nfsfh
, int uid
, int gid
);
805 * Async utimes(<path>)
807 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
808 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
810 * When the callback is invoked, status indicates the result:
813 * -errno : An error occured.
814 * data is the error string.
816 EXTERN
int nfs_utimes_async(struct nfs_context
*nfs
, const char *path
, struct timeval
*times
, nfs_cb cb
, void *private_data
);
818 * Sync utimes(<path>)
820 * 0 : The operation was successfull.
821 * -errno : The command failed.
823 EXTERN
int nfs_utimes(struct nfs_context
*nfs
, const char *path
, struct timeval
*times
);
830 * Async utime(<path>)
832 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
833 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
835 * When the callback is invoked, status indicates the result:
838 * -errno : An error occured.
839 * data is the error string.
842 EXTERN
int nfs_utime_async(struct nfs_context
*nfs
, const char *path
, struct utimbuf
*times
, nfs_cb cb
, void *private_data
);
846 * 0 : The operation was successfull.
847 * -errno : The command failed.
849 EXTERN
int nfs_utime(struct nfs_context
*nfs
, const char *path
, struct utimbuf
*times
);
858 * Async access(<path>)
860 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
861 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
863 * When the callback is invoked, status indicates the result:
866 * -errno : An error occured.
867 * data is the error string.
869 EXTERN
int nfs_access_async(struct nfs_context
*nfs
, const char *path
, int mode
, nfs_cb cb
, void *private_data
);
871 * Sync access(<path>)
873 * 0 : The operation was successfull.
874 * -errno : The command failed.
876 EXTERN
int nfs_access(struct nfs_context
*nfs
, const char *path
, int mode
);
885 * Async symlink(<path>)
887 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
888 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
890 * When the callback is invoked, status indicates the result:
893 * -errno : An error occured.
894 * data is the error string.
896 EXTERN
int nfs_symlink_async(struct nfs_context
*nfs
, const char *oldpath
, const char *newpath
, nfs_cb cb
, void *private_data
);
898 * Sync symlink(<path>)
900 * 0 : The operation was successfull.
901 * -errno : The command failed.
903 EXTERN
int nfs_symlink(struct nfs_context
*nfs
, const char *oldpath
, const char *newpath
);
910 * Async rename(<oldpath>, <newpath>)
912 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
913 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
915 * When the callback is invoked, status indicates the result:
918 * -errno : An error occured.
919 * data is the error string.
921 EXTERN
int nfs_rename_async(struct nfs_context
*nfs
, const char *oldpath
, const char *newpath
, nfs_cb cb
, void *private_data
);
923 * Sync rename(<oldpath>, <newpath>)
925 * 0 : The operation was successfull.
926 * -errno : The command failed.
928 EXTERN
int nfs_rename(struct nfs_context
*nfs
, const char *oldpath
, const char *newpath
);
936 * Async link(<oldpath>, <newpath>)
938 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
939 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
941 * When the callback is invoked, status indicates the result:
944 * -errno : An error occured.
945 * data is the error string.
947 EXTERN
int nfs_link_async(struct nfs_context
*nfs
, const char *oldpath
, const char *newpath
, nfs_cb cb
, void *private_data
);
949 * Sync link(<oldpath>, <newpath>)
951 * 0 : The operation was successfull.
952 * -errno : The command failed.
954 EXTERN
int nfs_link(struct nfs_context
*nfs
, const char *oldpath
, const char *newpath
);
962 * NOTE: You must include 'libnfs-raw-mount.h' to get the definitions of the
963 * returned structures.
965 * This function will return the list of exports from an NFS server.
968 * 0 : The operation was initiated. Once the operation finishes, the callback will be invoked.
969 * <0 : An error occured when trying to set up the operation. The callback will not be invoked.
971 * When the callback is invoked, status indicates the result:
973 * data is a pointer to an exports pointer:
974 * exports export = *(exports *)data;
975 * -errno : An error occured.
976 * data is the error string.
978 EXTERN
int mount_getexports_async(struct rpc_context
*rpc
, const char *server
, rpc_cb cb
, void *private_data
);
980 * Sync getexports(<server>)
982 * NULL : something failed
983 * exports export : a linked list of exported directories
985 * returned data must be freed by calling mount_free_export_list(exportnode);
987 EXTERN
struct exportnode
*mount_getexports(const char *server
);
989 EXTERN
void mount_free_export_list(struct exportnode
*exports
);
992 //qqq replace later with lseek(cur, 0)
993 off_t
nfs_get_current_offset(struct nfsfh
*nfsfh
);
999 struct nfs_server_list
{
1000 struct nfs_server_list
*next
;
1005 * Sync find_local_servers(<server>)
1006 * This function will probe all local networks for NFS server. This function will
1007 * block for one second while awaiting for all nfs servers to respond.
1010 * NULL : something failed
1012 * struct nfs_server_list : a linked list of all discovered servers
1014 * returned data must be freed by nfs_free_srvr_list(srv);
1016 struct nfs_server_list
*nfs_find_local_servers(void);
1017 void free_nfs_srvr_list(struct nfs_server_list
*srv
);