API:EPrints/Platform

From EPrints Documentation
Revision as of 13:21, 25 February 2010 by Tdb01r (talk | contribs)
Jump to: navigation, search

EPrints 3 Reference: Directory Structure - Metadata Fields - Repository Configuration - XML Config Files - XML Export Format - EPrints data structure - Core API - Data Objects


API: Core API

Latest Source Code (3.4, 3.3) | Revision Log | Before editing this page please read Pod2Wiki


NAME

EPrints::Platform - handles platform specific code.

User Comments


DESCRIPTION

When you call a method in this class, it is sent to the appropriate EPrints::Platform::xxx module. Usually this is EPrints::Platform::Unix

Which module is used is configured by the {platform} setting in SystemSettings.pm

All file and directory names are absolute and joined by the Unix file separator character '/'.

User Comments


chmod( MODE, @filelist )

Change the access control on files listed in @filelist to MODE.

User Comments


chown( $uid, $gid, @filelist )

Change the user and group on files listed in @filelist to $uid and $gid. $uid and $gid are as returned by getpwnam (usually numeric).

User Comments


getpwnam( $user )

Return the login-name, password crypt, uid and gid for user $user.

User Comments


getpwnam( $user )

Return the login-name, password crypt, uid and gid for user $user.

User Comments


test_uid()

Test whether the current user is the same that is configured in SystemSettings.

User Comments


mkdir( $path, MODE )

Create a directory $path (including parent directories as necessary) set to mode MODE. If MODE is undefined defaults to dir_perms in SystemSettings.

User Comments


exec()

Executes certain named tasks, which were once (and may be) handled by external binaries. This allows a per-platform solution to each task. (example is unpacking a .tar.gz file).

User Comments


$rc = read_perl_script( $repository, $filename, @args )

Executes Perl with @args, including the current EPrints library path. Writes output from the script to $filename (errors and stdout).

Returns 0 on success.

User Comments


get_hash_name()

Returns the last part of the filename of the hashfile for a document. (yes, it's a bad function name.)

User Comments


free_space( $dir )

Return the amount of free space (in bytes) available at $dir. $dir may contain a drive (C:) on Windows platforms.

User Comments


$bool = proc_exists( $pid )

Returns true if a process exists using id $pid.

Returns undef if process identification is unsupported.

User Comments