TWiki> LCG Web>LCGGridDeployment>LCGSoftware>DataManagementTop>DataManagementDocumentation>LfcApi (2009-06-26, AkosFrohner) EditAttachPDF

LFC API / CLI

All the LFC man pages can be found here : LFC CLI and API.

Below is a description of each LFC command / method.

LFC Client Timeouts

From version 1.5.8 onwards, timeouts and retries are implemented at the LFC client level.

3 environment variables can be used:

  • $LFC_CONNTIMEOUT -> sets the connect timeout in seconds
  • $LFC_CONRETRY -> sets the number of retries
  • $LFC_CONRETRYINT -> sets the retry interval in seconds

The default is to retry for one week.

LFC Command Line Interface

COMMAND DESCRIPTION
lfc-chmod change access mode of a LFC directory/file in the name server
lfc-chown change owner and group of a LFC directory/file in the name server
lfc-delcomment delete the comment associated with a file/directory
lfc-entergrpmap define a new group entry in Virtual Id table
lfc-enterusrmap define a new user entry in Virtual Id table
lfc-getacl get LFC directory/file access control lists
lfc-ln make a symbolic link to a file or a directory in the LFC Name Server
lfc-ls list LFC name server directory/file entries
lfc-mkdir make LFC directory in the name server
lfc-modifygrpmap modify group entry corresponding to a given virtual gid
lfc-modifyusrmap modify user entry corresponding to a given virtual uid
lfc-rename rename a LFC file or directory in the name server
lfc-rm remove LFC files or directories in the name server
lfc-rmgrpmap suppress group entry corresponding to a given virtual gid or group name
lfc-rmusrmap suppress user entry corresponding to a given virtual uid or user name
lfc-setacl set LFC directory/file access control lists
lfc-setcomment add/replace a comment associated with a file/directory

For more details, please refer to the corresponding man page.

LFC API

COMMAND DESCRIPTION
lfc_aborttrans abort a transaction
lfc_access check existence/accessibility of a file/directory
lfc_addreplica add a replica for a given file
lfc_chdir change LFC current directory used by the name server
lfc_chmod change access mode of a LFC directory/file in the name
lfc_chown change owner and group of a LFC directory/file in the name server
lfc_closedir close LFC directory opened by lfc_opendir in the name server
lfc_creatg create a new LFC file with the specified GUID or reset it in the name server
lfc_delcomment delete the comment associated with a LFC file/directory in the name server
lfc_delreplica delete a replica for a given file
lfc_endsess end session
lfc_endtrans end transaction mode
lfc_entergrpmap define a new group entry in Virtual Id table
lfc_enterusrmap define a new user entry in Virtual Id table
lfc_getacl get LFC directory/file access control lists
lfc_getcomment get the comment associated with a LFC file/directory in the name server
lfc_getcwd get LFC current directory used by the name server
lfc_getgrpbygid get group name associated with a given virtual gid
lfc_getgrpbynam get virtual gid associated with a given group name
lfc_getidmap get virtual uid/gid(s) associated with a given dn/role(s)
lfc_getlinks get the link entries associated with a given file
lfc_getreplica get the replica entries associated with a LFC file in the name server
lfc_getusrbynam get virtual uid associated with a given user name
lfc_getusrbyuid get user name associated with a given virtual uid
lfc_lchown identical to lfc_chown except for symbolic links: it does not follow the link but changes the ownership of the link itself
lfc_listlinks list link entries for a given file
lfc_listrep4gc list replica entries that can be garbage collected
lfc_listreplica list replica entries for a given file
lfc_listreplicax list replica entries for a given pool/server/filesystem
lfc_mkdir create a new LFC directory in the name server
lfc_mkdirg create a new LFC directory in the name server with the specified GUID
lfc_modifygrpmap modify group entry corresponding to a given virtual gid
lfc_modifyusrmap modify user entry corresponding to a given virtual uid
lfc_opendirg open a LFC directory, having the specified GUID, in the name server
lfc_opendirxg open a LFC directory, having the specified GUID, in the name server
lfc_readdir read LFC directory opened by lfc_opendir in the name server
lfc_readdirc identical to lfc_readdir + returns the comments
lfc_readdirg identical to lfc_readdir + returns the GUID
lfc_readdirxc  
lfc_readdirxr identical to lfc_readdir + returns the replicas
lfc_readlink read value of a symbolic link in the LFC Name Server
lfc_rename rename a LFC file or directory in the name server
lfc_rewinddir reset position to the beginning of a LFC directory opened by lfc_opendir in the name server
lfc_rmdir remove a LFC directory in the name server
lfc_rmgrpmap suppress group entry corresponding to a given virtual gid or group name
lfc_rmusrmap suppress user entry corresponding to a given virtual uid or user name
lfc_setacl set LFC directory/file access control lists
lfc_setatime set last access time for a regular file to the current time
lfc_setcomment add/replace a comment associated with a LFC file/directory in the name server
lfc_seterrbuf set receiving buffer for error messages
lfc_setfsize set filesize for a regular file; set also last modification time to the current time
lfc_setfsizeg set filesize for a regular file having the given GUID; set also last modification time to the current time
lfc_setptime set replica pin time
lfc_setratime set replica last access (read) date
lfc_setrstatus set replica status
lfc_startsess start session
lfc_starttrans start transaction mode
lfc_statg get information about a LFC file or directory in the name server
lfc_statr get information about a LFC file or directory in the name server
lfc_symlink make a symbolic link to a file or a directory in the LFC Name Server
lfc_umask set and get LFC file creation mask used by the name server
lfc_unlink remove a LFC file entry in the name server
lfc_utime set last access and modification times

For more details, please refer to the corresponding man page.

Perl / Python Interfaces

Please refer to the lfc_perl and lfc_python man pages for details and usage examples.

Help !

For any help/question, please contact GGUS at helpdesk@ggusNOSPAMPLEASE.org (remove the NOSPAM !). Your ROC will help you, and contact the appropriate experts if necessary.

-- SophieLemaitre - 16 Mar 2006

Edit | Attach | Watch | Print version | History: r4 < r3 < r2 < r1 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r4 - 2009-06-26 - AkosFrohner
 
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    LCG All webs login

This site is powered by the TWiki collaboration platform Powered by PerlCopyright &© 2008-2023 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
or Ideas, requests, problems regarding TWiki? use Discourse or Send feedback