man/cat1p/link.1p.txt

link(P) link(P)
 
 
 
 
 
NAME
       link - call link function
 
SYNOPSIS
       link file1 file2
 
DESCRIPTION
       The link utility shall perform the function call:
 
 
              link(file1, file2);
 
       A user may need appropriate privilege to invoke the link
       utility.
 
OPTIONS
       None.
 
OPERANDS
       The following operands shall be supported:
 
       file1 The pathname of an existing file.
 
       file2 The pathname of the new directory entry to be
              created.
 
 
STDIN
       Not used.
 
INPUT FILES
       Not used.
 
ENVIRONMENT VARIABLES
       The following environment variables shall affect the
       execution of link:
 
       LANG Provide a default value for the internationaliza-
              tion variables that are unset or null. (See the
              Base Definitions volume of IEEE Std 1003.1-2001,
              Section 8.2, Internationalization Variables for
              the precedence of internationalization variables
              used to determine the values of locale cate-
              gories.)
 
       LC_ALL If set to a non-empty string value, override the
              values of all the other internationalization
              variables.
 
       LC_CTYPE
              Determine the locale for the interpretation of
              sequences of bytes of text data as characters
              (for example, single-byte as opposed to multi-
              byte characters in arguments).
 
       LC_MESSAGES
 
              Determine the locale that should be used to
              affect the format and contents of diagnostic mes-
              sages written to standard error.
 
       NLSPATH
              Determine the location of message catalogs for
              the processing of LC_MESSAGES .
 
 
ASYNCHRONOUS EVENTS
       Default.
 
STDOUT
       None.
 
STDERR
       The standard error shall be used only for diagnostic
       messages.
 
OUTPUT FILES
       None.
 
EXTENDED DESCRIPTION
       None.
 
EXIT STATUS
       The following exit values shall be returned:
 
        0 Successful completion.
 
       >0 An error occurred.
 
 
CONSEQUENCES OF ERRORS
       Default.
 
       The following sections are informative.
 
APPLICATION USAGE
       None.
 
EXAMPLES
       None.
 
RATIONALE
       None.
 
FUTURE DIRECTIONS
       None.
 
SEE ALSO
       ln , unlink() , the System Interfaces volume of
       IEEE Std 1003.1-2001, link()
 
COPYRIGHT
       Portions of this text are reprinted and reproduced in
       electronic form from IEEE Std 1003.1, 2003 Edition,
       Standard for Information Technology -- Portable Operat-
       ing System Interface (POSIX), The Open Group Base Speci-
       fications Issue 6, Copyright (C) 2001-2003 by the Insti-
       tute of Electrical and Electronics Engineers, Inc and
       The Open Group. In the event of any discrepancy between
       this version and the original IEEE and The Open Group
       Standard, the original IEEE and The Open Group Standard
       is the referee document. The original Standard can be
       obtained online at http://www.open-
       group.org/unix/online.html .
 
 
 
POSIX 2003 link(P)