Linux Certif

Toute la documentation sur la certification Linux LPI

renameat

̾Á°

renameat - ¥Ç¥£¥ì¥¯¥È¥ê¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤«¤éÁêÂÐŪ¤Ê°ÌÃ֤ˤ¢¤ë¥Õ¥¡¥¤¥ë¤Î̾Á°¤òÊѹ¹¤¹¤ë

½ñ¼°

#define _ATFILE_SOURCE

#include <stdio.h>



int renameat(int olddirfd, const char *oldpath,

             int newdirfd, const char *newpath);

ÀâÌÀ

renameat() ¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¡¢¤³¤Î man ¥Ú¡¼¥¸¤ÇÀâÌÀ¤·¤Æ¤¤¤ë°ã¤¤¤¬¤¢¤ë°Ê³°¤Ï¡¢ rename(2) ¤ÈÁ´¤¯Æ±¤¸¤è¤¦¤ËÆ°ºî¤¹¤ë¡£

oldpath ¤Ç»ØÄꤵ¤ì¤ë¥Ñ¥¹Ì¾¤¬ÁêÂХѥ¹¤Ç¤¢¤ë¾ì¹ç¡¢ ¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿ olddirfd ¤Ç»²¾È¤µ¤ì¤ë¥Ç¥£¥ì¥¯¥È¥ê¤«¤é¤ÎÁêÂХѥ¹Ì¾¤È¤·¤Æ²ò¼á¤µ¤ì¤ë (rename(2) ¤Ç¤Ï¡¢ÁêÂХѥ¹¤Ï¸Æ¤Ó½Ð¤·¸µ¥×¥í¥»¥¹¤Î¥«¥ì¥ó¥È¥ï¡¼¥­¥ó¥°¥Ç¥£¥ì¥¯¥È¥ê¤«¤é¤Î ÁêÂХѥ¹¤È¤Ê¤ë)¡£

oldpath ¤¬ÁêÂХѥ¹¤Ç¤¢¤ê¡¢¤«¤Ä olddirfd ¤¬ÆÃÊ̤ÊÃÍ AT_FDCWD ¤Ç¤¢¤ë¾ì¹ç¡¢ oldpath ¤Ï (rename(2) ¤ÈƱ¤¸¤è¤¦¤Ë) ¸Æ¤Ó½Ð¤·¸µ¥×¥í¥»¥¹¤Î ¥«¥ì¥ó¥È¥ï¡¼¥­¥ó¥°¥Ç¥£¥ì¥¯¥È¥ê¤«¤é¤ÎÁêÂХѥ¹Ì¾¤È¤·¤Æ²ò¼á¤µ¤ì¤ë¡£

oldpath ¤¬ÀäÂХѥ¹¤Ç¤¢¤ë¾ì¹ç¡¢ olddirfd ¤Ï̵»ë¤µ¤ì¤ë¡£

newpath ¤Î²ò¼á¤Ï oldpath ¤ÈƱÍͤǤ¢¤ë¤¬¡¢ ÁêÂХѥ¹Ì¾¤Ï¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿ newdirfd ¤Ç»²¾È¤µ¤ì¤ë¥Ç¥£¥ì¥¯¥È¥ê¤«¤é¤ÎÁêÂХѥ¹Ì¾¤È¤·¤Æ²ò¼á¤µ¤ì¤ë¡£

ÊÖ¤êÃÍ

À®¸ù¤·¤¿¾ì¹ç¡¢ renameat() ¤Ï 0 ¤òÊÖ¤¹¡£ ¥¨¥é¡¼¤Î¾ì¹ç¡¢-1 ¤¬ÊÖ¤µ¤ì¤Æ¡¢ errno ¤Ë¤Ï¥¨¥é¡¼¤ò¼¨¤¹Ãͤ¬ÀßÄꤵ¤ì¤ë¡£

¥¨¥é¡¼

rename(2) ¤ÈƱ¤¸¥¨¥é¡¼¤¬ renameat() ¤Ç¤âµ¯¤³¤ë¡£ renameat() ¤Ç¤Ï¡¢¤½¤Î¾¤Ë°Ê²¼¤Î¥¨¥é¡¼¤¬µ¯¤³¤ë:

EBADF

olddirfd ¤Þ¤¿¤Ï newdirfd ¤¬Í­¸ú¤Ê¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤Ê¤¤¡£

ENOTDIR

oldpath ¤¬ÁêÂХѥ¹¤Ç¡¢¤«¤Ä olddirfd ¤¬¥Ç¥£¥ì¥¯¥È¥ê°Ê³°¤Î¥Õ¥¡¥¤¥ë¤ò»²¾È¤¹¤ë¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤¢¤ë¡£ ¤Þ¤¿¤Ï newpath ¤È newdirfd ¤Ë¤Ä¤¤¤Æ¡¢Æ±ÍͤΤ³¤È¤¬µ¯¤­¤Æ¤¤¤ë¡£

¥Ð¡¼¥¸¥ç¥ó

renameat() ¤Ï Linux ¥«¡¼¥Í¥ë 2.6.16 ¤ÇÄɲ䵤줿¡£

½àµò

¤³¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ïɸ½àŪ¤Ç¤Ï¤Ê¤¤¤¬¡¢ POSIX.1 ¤Î¾­Íè¤Î¥ê¥Ó¥¸¥ç¥ó¤Ë´Þ¤á¤ë¤³¤È¤¬Äó°Æ¤µ¤ì¤Æ¤¤¤ë¡£

Ãí°Õ

renameat() ¤¬É¬ÍפÊÍýͳ¤Ë¤Ä¤¤¤Æ¤Ï¡¢ openat(2) ¤ò»²¾È¤¹¤ë¤³¤È¡£

´ØÏ¢¹àÌÜ

openat(2), rename(2), path_resolution(7)