1. History

2. Links

3. Specification

4. See also

5. References

6. External links

The {{code|ln}} command is a standard Unix command utility used to create a hard link or a symbolic link (symlink) to an existing file.^[1] The use of a hard link allows multiple filenames to be associated with the same file since a hard link points to the inode of a given file, the data of which is stored on disk. On the other hand, symbolic links are special files that refer to other files by name.^[2]

The {{code|ln}} command by default creates hard links, and when called with the command line parameter {{code|ln -s}} creates symbolic links.^[3] Most operating systems prevent hard links to directories from being created since such a capability could disrupt the structure of a file system and interfere with the operation of other utilities.^[4] The {{code|ln}} command can however be used to create symbolic links to non-existent files.^[2]

History

The version of {{code|ln}} bundled in GNU coreutils was written by Mike Parker and David MacKenzie.^[5]

Links

Links allow more than one filename to refer to the same file as in the case of a hard link or act as pointers to a filename as in the case of a soft link. Both hard links and soft links can be created by the {{code|ln}} command. Specifically,

1. Hard links, also known simply as links, are objects that associate the filename with the inode, and therefore the file contents itself.^&91;1&93; A given file on disk could have multiple links scattered through the directory hierarchy, with all of the links being equivalent since they all associate with the same inode.^&91;8&93; Creating a link therefore does not copy the contents of the file but merely causes another name to be associated with the same contents. Each time a hard link is created, a link counter that is a part of the inode structure gets incremented; a file is not deleted until its reference count reaches zero.^{&91;1&93;&91;6&93;} However, hard links can only be created on the same file system; this can prove to be a disadvantage.^&91;7&93;
2. Symbolic links are special files which, when encountered during pathname resolution, modify the pathname resolution to be taken to the location which the symbolic link contains. The content of the symbolic link is therefore the destination path string, which can also be examined using the {{code|readlink}} command line utility.^&91;8&93; The symbolic link may contain an arbitrary string which does not refer to the location of an existing file. Such a symbolic link will fail until a file is created at the location which is contained by the symbolic link. By contrast, a symbolic link to an existing file will fail if the existing file is moved to a different location (or renamed).^&91;9&93;

Specification

The {{code|ln}} utility on systems compliant with the Single Unix Specification is specified in the Shell and Utilities (XCU) document, which forms a part of the Single Unix Specification.^[10][11]

The specification describes two ways of invoking the {{code|ln}} utility.^[12] Specifically,

In the "single file" invocation the {{code|ln}} utility creates a new hard link (directory entry) for the source file specified by the {{code|source_file}} operand at the destination path specified by the {{code|target_file}} operand. However, if the {{code|-s}} option is specified, a symbolic link is created.

ln [-fs] [-L|-P] source_file target_file

In the "multiple file" invocation the {{code|ln}} utility creates a new hard link (directory entry), or if the {{code|-s}} option is specified, a symbolic link, for each file specified by the {{code|source_file}} operand, at a destination path in an existing directory named by operand {{code|target_file}}.

ln [-fs] [-L|-P] source_file_1 source_file_2 ... target_dir

The specification also specifies the command line options that must be supported:

{{code|-f}} Force existing destination pathnames to be removed to allow the link.

{{code|-L}} For each {{code|source_file}} operand that names a file that is a symbolic link, create a hard link to the file referenced by the symbolic link.

{{code|-P}} For each {{code|source_file}} operand that names a file that is a symbolic link, create a (hard) link to the symbolic link itself.

{{code|-s}} Create symbolic links instead of hard links. If the -s option is specified, the -L and -P options are silently ignored.

If more than one of the mutually-exclusive options {{code|-L}} and {{code|-P}} is specified the last option specified determines the behavior of the utility.

If the {{code|-s}} option is not specified and neither a {{code|-L}} nor a {{code|-P}} option is specified, the implementation defines which of the {{code|-L}} and {{code|-P}} options will be used as the default.

If neither target file nor target directory are specified, links will be created in the current working directory.

See also

• List of Unix commands
• NTFS junction point

References

External links

• {{man|1|ln|die.net}}
• {{man|1|ln|FreeBSD}}
• {{man|1|ln|NetBSD}}
• {{man|1|ln|OpenBSD}}
• {{man|1|ln|Darwin}}

• Li Gu (Han dynasty)
• Li gui
• Li gui (bronze)
• Li Gui (prince)
• Ligula intestinalis
• Ligulariopsis shichuana
• Ligulata
• Ligulate flower
• Ligulate head
• Li Gu (Later Zhou)
• Ligule (Asteraceae)
• Ligulf of Lumley
• Liguliflorae
• Ligumia subrostrata
• Li Gun-mo
• Liguo, Hainan
• Li Guojun
• Liguori Publications
• Li Guowei
• Li Guowen
• Ligure (train)
• Liguria Bakery
• Ligurian (ancient language)
• Ligurian language (Romance language)
• Ligurian (wine)