]> git.donarmstrong.com Git - samtools.git/blobdiff - knetfile.h
* samtools-0.1.4-21 (r368)
[samtools.git] / knetfile.h
index 7fc86c244490e0d179ee24f80b79b94dcd905139..bf45f3df809b8f3ebd54b17c711dd188ab3dbb36 100644 (file)
@@ -16,8 +16,9 @@ typedef struct knetFile_s {
        char *host;
 
        // the following are for FTP only
-       int ctrl_fd, pasv_ip[4], pasv_port, max_response, no_reconnect;
+       int ctrl_fd, pasv_ip[4], pasv_port, max_response, no_reconnect, is_ready;
        char *response, *retr;
+       int64_t seek_offset; // for lazy seek
 } knetFile;
 
 #define knet_tell(fp) ((fp)->offset)
@@ -28,8 +29,22 @@ extern "C" {
 #endif
 
        knetFile *knet_open(const char *fn, const char *mode);
+
+       /* 
+          This only works with local files.
+        */
        knetFile *knet_dopen(int fd, const char *mode);
+
+       /*
+         If ->is_ready==0, this routine updates ->fd; otherwise, it simply
+         reads from ->fd.
+        */
        off_t knet_read(knetFile *fp, void *buf, off_t len);
+
+       /*
+         This routine only sets ->offset and ->is_ready=0. It does not
+         communicate with the FTP server.
+        */
        int knet_seek(knetFile *fp, off_t off, int whence);
        int knet_close(knetFile *fp);