@c ----------------------------------------------------------------------
@node ftell, stdio
@heading @code{ftell}
@subheading Syntax

@example
#include <stdio.h>

long ftell(FILE *file);
@end example

@subheading Description

Returns the current file position for @code{file}.  This is suitable for
a future call to @code{fseek}. 

@subheading Return Value

The file position, or -1 on error. 

@subheading Example

@example
long p = ftell(stdout);
@end example

@c ----------------------------------------------------------------------
@node ftime, time
@heading @code{ftime}
@subheading Syntax

@example
#include <sys/timeb.h>

int ftime(struct timeb *buf);
@end example

@subheading Description

This function stores the current time in the structure @var{buf}.  The
format of @code{struct timeb} is:

@example
struct timeb @{
  time_t         time;     /* seconds since 00:00:00 GMT 1/1/1970 */
  unsigned short millitm;  /* milliseconds */
  short          timezone; /* difference between GMT and local, minutes */
  short          dstflag;  /* set if daylight savings time in affect */
@};
@end example

@subheading Return Value

Zero on success, nonzero on error.

@subheading Example

@example
struct timeb t;
ftime(&t);
@end example

@c ----------------------------------------------------------------------
@node ftruncate, stdio
@heading @code{ftruncate}
@subheading Syntax

@example
#include <osfcn.h>

int ftruncate(int file, unsigned long where);
@end example

@subheading Description

This function truncates @var{file} at @var{where} length.  This only
works if the file is closed right after this call. 

@subheading Return Value

Zero for success, nonzero for failure.

@subheading Example

@example
int x = open("data", O_WRONLY);
ftruncate(x, 1000);
close(x);
@end example

