DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

CURLOPT_DIRLISTONLY(3)





CURLOPT_DIRLISTONLY(3curl_easy_setopt optionCURLOPT_DIRLISTONLY(3)



NAME

     CURLOPT_DIRLISTONLY - ask for  names  only  in  a  directory
     listing


SYNOPSIS

     #include <curl/curl.h>

     CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DIRLISTONLY,
     long listonly);


DESCRIPTION

     For FTP and SFTP based URLs a parameter set to 1  tells  the
     library  to  list  the names of files in a directory, rather
     than performing a full directory listing that would normally
     include file sizes, dates etc.

     For POP3 a parameter of 1 tells  the  library  to  list  the
     email  message  or  messages on the POP3 server. This can be
     used to change the default behaviour of libcurl,  when  com-
     bined  with  a  URL that contains a message ID, to perform a
     "scan listing" which can then be used to determine the  size
     of an email.

     Note: For FTP this causes a NLST command to be sent  to  the
     FTP server.  Beware that some FTP servers list only files in
     their response to NLST; they  might  not  include  subdirec-
     tories and symbolic links.

     Setting this option to 1 also implies  a  directory  listing
     even if the URL doesn't end with a slash, which otherwise is
     necessary.

     Do   NOT   use    this    option    if    you    also    use
     CURLOPT_WILDCARDMATCH(3)  as  it will effectively break that
     feature then.


DEFAULT

     0, disabled


PROTOCOLS

     FTP, SFTP and POP3


EXAMPLE

     CURL *curl = curl_easy_init();
     if(curl) {
       curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/dir/");

       /* list only */
       curl_easy_setopt(curl, CURLOPT_DIRLISTONLY, 1L);

       ret = curl_easy_perform(curl);

libcurl 7.58.0      Last change: May 05, 2017                   1


CURLOPT_DIRLISTONLY(3curl_easy_setopt optionCURLOPT_DIRLISTONLY(3)


       curl_easy_cleanup(curl);
     }


AVAILABILITY

     This option was known as CURLOPT_FTPLISTONLY up  to  7.16.4.
     POP3 is supported since 7.21.5.


RETURN VALUE

     Returns  CURLE_OK  if   the   option   is   supported,   and
     CURLE_UNKNOWN_OPTION if not.


SEE ALSO

     CURLOPT_CUSTOMREQUEST(3),

libcurl 7.58.0      Last change: May 05, 2017                   2


Man(1) output converted with man2html