---
name: "FtpDir"
section: "3"
platform: "linux"
package: "ftplib-dev"
version: "3.1-1-9"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/FtpDir"
---

# FtpDir(3)

Performs a verbose directory.

## NAME

FtpDir - Performs a verbose directory.

## SYNOPSIS

**#include \<ftplib.h\>**\

**int FtpDir(const char \****outputfile***, const char \****path***,**

**netbuf \****nControl***);**

## PARAMETERS

- **outputfile**

  Name of a local file to receive the directory listing.

- **path**

  File specification to pass to remote 'ls'.

- **nControl**

  A handle returned by FtpConnect().

## DESCRIPTION

Sends a LIST command to the server with the specified path. The response to this is usually a long format directory listing which will be written to the file named in outputfile. If outputfile is specified as NULL, the list will be written to stdout.

## RETURN VALUE

Returns 1 if successful or 0 on error.