HELPLIB.HLB  —  CRTL  getname
    Returns the file specification associated with a file descriptor.

    Format

      #include  <unixio.h>

      char *getname  (int file_desc, char *buffer, . . . );

1  –  Function Variants

    The getname function has variants named _getname32 and _getname64
    for use with 32-bit and 64-bit pointer sizes, respectively.

2  –  Arguments

 file_desc

    A file descriptor.

 buffer

    A pointer to a character string that is large enough to hold the
    file specification.

  . . .

    An optional argument that can be either 1 or 0. If you specify
    1, the getname function returns the file specification in OpenVMS
    format. If you specify 0, the getname function returns the file
    specification in UNIX style format. If you omit this argument,
    the getname function returns the filename according to your
    current command-language interpreter (CLI).

3  –  Description

    The getname function places the file specification into the
    area pointed to by buffer and returns that address. The area
    pointed to by buffer should be an array large enough to contain
    a fully qualified file specification (the maximum length is 256
    characters).

4  –  Return Values

    x                  The address passed in the buffer argument.
    0                  Indicates an error.
Close Help