Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
128 lines (64 sloc) 4.33 KB

type: symlink

Symlinks, or symbolic links, are the Unix version of shortcut files (pointers to other files). inspectors can analyze the file objects (files and folders) that symlinks point to by using the standard file inspectors. The symlink inspectors, on the other hand, allow you to analyze the properties of a symlink itself, not just the underlying file. There are many properties that symlinks have in common with files, such as name, pathname, parent folder, and more. In addition, a symlink has a value corresponding to the file object it points to. You can also determine if the file is available or not.

accessed time of <symlink> : time

Returns the last accessed time of the specified symlink.

ancestor of <symlink> : folder

Returns all ancestor folders (recursive parent folders) of the given symlink.

change time of <symlink> : time

Returns the last time the specified symlink was 'changed' by either writing it or setting its inode information.

device file <symlink> : device file

Returns the device file specified by the supplied symbolic link.

drive of <symlink> : filesystem

Returns the drive associated with the specified symlink as a <filesystem> object.

fifo file <symlink> : fifo file

Returns the FIFO file (named pipe) described by the specified symbolic link (symlink).

file <symlink> : file

Returns the file pointed to by the specified symlink. If the file doesn't exist, this inspector will throw a 'non-existent object' error.

filesystem of <symlink> : filesystem

Returns the filesystem on which the symlink resides.

folder <symlink> : folder

Returns the folder pointed to by the specified symlink.

gid of <symlink> : integer

Returns the group ID of the given symlink.

group name of <symlink> : string

Returns the group name of the specified symlink.

link count of <symlink> : integer

Returns an integer corresponding to the number of hard links attached to the specified symlink.

location of <symlink> : string

Returns a string corresponding to the directory in which the symlink is located.

modification time of <symlink> : time

Returns the time corresponding to the modification time of the specified symlink, not the file it points to.Example: modification time of symlink "/example/link" - Returns the time corresponding to the modification time of the given symlink, not the file it points to.Example: modification time of file "/example/link" - Returns the time corresponding to the file object that the symlink is pointing to.

name of <symlink> : string

Returns a string that is the full pathname of the specified symlink.

parent folder of <symlink> : folder

Creates a folder object corresponding to the parent folder of the given symlink.

pathname of <symlink> : string

Returns a string that contains the full pathname of the specified symlink.

socket file <symlink> : socket file

Returns the socket file(s) indicated by the supplied symlink.

symlink <symlink> : symlink

Returns a symlink from the specified symlink path, even if the symlink is broken.

uid of <symlink> : integer

The user ID of the user who owns this symlink.

user name of <symlink> : string

Returns the symlink owner's (user's) name.

value accessible of <symlink> : boolean

Returns True if the pathname pointed to by the specified symlink is available. Returns False if the file object is missing or unavailable with the current permissions.

value of <symlink> : string

Returns the pathname that the symlink points to.

<symlink> as binary_string : binary_string

Returns a binary string for a full path of symbolic link.

<symlink> as device file : device file

Casts a symlink type as a device file type.

<symlink> as fifo file : fifo file

Casts a symlink type as a FIFO (named pipe) file.

<symlink> as file : file

Converts a symlink object into the file it points to.

<symlink> as folder : folder

Converts a symlink object into the folder it points to.

<symlink> as socket file : socket file

Casts a symlink type as a socket file type.

<symlink> as string : string

Casts a symlink object as a string.

<symlink> as symlink : symlink

Casts a symlink, provided for completeness.

You can’t perform that action at this time.