ftptrcon()

The ftptrcon() call opens the trace file specified and starts tracing.

Syntax

#include <ftpapi.h>

int ftptrcon(fileSpec, mode)
char *fileSpec;
int mode;

Parameters

fileSpec

Identifies the name of the trace file.

Specifies the trace mode as overwrite or append. Use M_OVERLAY for trace data which overwrites previous information. Use M_APPEND for trace data which appends to previous information.

Description

The ftptrcon() call opens the trace file specified and starts tracing of the command and reply sequences sent over the control connection between the local and remote hosts. The trace file can be written over or appended to.

No notification is provided if writing of trace data fails.

Telnet command and reply sequences are not traced nor are command and reply sequences between the local host and a proxy host.

Return Values

There are three possible return values for ftptrcon():

• when successful 
  TRCMODE indicates the value set into mode was not valid
  
  TRCOPEN indicates the trace file could not be opened

  Examples

  To write the trace data into a file named api.trc in the C:\WORK directory, use :

  int rc;rc = ftptrcon("c\\work\\api.trc", M_OVERLAY);
  

  If the file already existed, the new trace data overwrites the previous trace data (overlay mode).

  ---

  [Back: ftptrcoff()]
  [Next: ftpver()]