home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / ncftp19.zip / ncftpls.txt < prev    next >
Text File  |  1999-08-29  |  3KB  |  132 lines
  1.  
  2.  
  3.  
  4. ncftpls(1)                                             ncftpls(1)
  5.  
  6.  
  7. NAME
  8.        ncftpls - Internet file transfer program for scripts
  9.  
  10. SYNOPSIS
  11.        ncftpls [options] ftp://url.style/host/path/name/
  12.  
  13. OPTIONS
  14.    Command line flags:
  15.        -1      Most basic format, one item per line.
  16.  
  17.        -l      Long list format.
  18.  
  19.        -x -XX  Additional ls flags to pass on to the server.
  20.  
  21.        -u XX   Use username XX instead of anonymous.
  22.  
  23.        -p XX   Use password XX with the username.
  24.  
  25.        -P XX   Use port number XX instead of the default FTP ser-
  26.                vice port (21).
  27.  
  28.        -d XX   Use the file XX for debug logging.
  29.  
  30.        -t XX   Timeout after XX seconds.
  31.  
  32.        -F      Use passive (PASV) data connections.
  33.  
  34.        -r XX   Redial a maximum of XX times  until  connected  to
  35.                the remote FTP server.
  36.  
  37. DESCRIPTION
  38.        The  purpose of ncftpls is to do remote directory listings
  39.        using the  File  Transfer  Protocol  without  entering  an
  40.        interactive  shell.   This lets you write shell scripts or
  41.        other unattended processes that can do FTP.
  42.  
  43.        The default behavior is to print the directory listing  in
  44.        columnized format (i.e. ls -CF), but that is not very use-
  45.        ful for scripting.  This example  uses  the  -1  flag,  to
  46.        print one file per line:
  47.  
  48.            $ ncftpls -1 ftp://ftp.probe.net/pub/ncftp/
  49.  
  50.        You  can  also do a remote "ls -l", by using "ncftpls -l".
  51.        If you want to try other flags, you have to use them  with
  52.        the  -x  flag.   For example, if you wanted to do a remote
  53.        "ls -lrt", you could do this:
  54.  
  55.            $ ncftpls -x "-lrt" ftp://ftp.probe.net/pub/ncftp/
  56.  
  57.        By default the program tries to open the remote  host  and
  58.        login  anonymously,  but  you  can  specify a username and
  59.        password information like you can with ncftpget or  ncftp-
  60.        put.
  61.  
  62.  
  63.  
  64.                             NCEMRSoft                           1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ncftpls(1)                                             ncftpls(1)
  71.  
  72.  
  73. DIAGNOSTICS
  74.        ncftpls returns the following exit values:
  75.  
  76.        0       Success.
  77.  
  78.        1       Could not connect to remote host.
  79.  
  80.        2       Could not connect to remote host - timed out.
  81.  
  82.        3       Transfer failed.
  83.  
  84.        4       Transfer failed - timed out.
  85.  
  86.        5       Directory change failed.
  87.  
  88.        6       Directory change failed - timed out.
  89.  
  90.        7       Malformed URL.
  91.  
  92.        8       Usage error.
  93.  
  94.        9       Error in login configuration file.
  95.  
  96.        10      Library initialization failed.
  97.  
  98.        11      Session initialization failed.
  99.  
  100. AUTHOR
  101.        Mike Gleason, NCEMRSoft (mgleason@probe.net).
  102.  
  103. SEE ALSO
  104.        ncftpput(1),   ncftpget(1),   ncftp(1),   ftp(1),  rcp(1),
  105.        tftp(1).
  106.  
  107.        LibNcFTP (http://www.probe.net/~mgleason/libncftp).
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                             NCEMRSoft                           2
  131.  
  132.