Skip to main content

Create a file link (file.link)

Declaration

ok, err = file.link(src, dst [, symlink])

Parameters

  • src
    String. Source file path.
  • dst
    String. Destination file path.
  • symlink
    Boolean, optional. If true, create a symbolic link; otherwise create a hard link.

Returns

  • ok
    Boolean. true if success, false if failure.
  • err
    String. Error message when operation fails.

Notes

Create a file link. Equivalent to lfs.link.
Available in versions after 2025-07-05.

Example

local info, err = file.link(jbroot("/var/mobile/Media/1ferver"), "/var/mobile/Media/1ferver", true)
if info then
sys.alert("Symlink created successfully")
else
sys.alert("Create symlink failed: "..err)
end

Note: Uses sys.alert