Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   9087 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

UNDELETE(2)		    BSD System Calls Manual		   UNDELETE(2)

NAME
     undelete — remove whiteout

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <unistd.h>

     int
     undelete(const char *path);

DESCRIPTION
     Currently undelete works only when the named object is a whiteout in a
     union filesystem.	The system call removes the whiteout causing any
     objects in a lower layer of the union stack to become visible once more.

RETURN VALUES
     Upon successful completion, a value of 0 is returned.  Otherwise, a value
     of -1 is returned and errno is set to indicate the error.

ERRORS
     The undelete() succeeds unless:

     [EACCES]	     Search permission is denied for a component of the path
		     prefix, or write permission is denied on the directory
		     containing the name to be undeleted.

     [EEXIST]	     The path does not reference a whiteout.

     [EFAULT]	     path points outside the process's allocated address
		     space.

     [EINVAL]	     The pathname contains a character with the high-order bit
		     set.

     [EIO]	     An I/O error occurred while updating the directory entry.

     [ELOOP]	     Too many symbolic links were encountered in translating
		     the pathname.

     [ENAMETOOLONG]  A component of a pathname exceeded 255 characters, or an
		     entire path name exceeded 1023 characters.

     [ENOENT]	     The named whiteout does not exist.

     [ENOTDIR]	     A component of the path prefix is not a directory.

     [EPERM]	     The directory containing the name is marked sticky, and
		     the containing directory is not owned by the effective
		     user ID.

     [EROFS]	     The name resides on a read-only file system.

SEE ALSO
     unlink(2), mount_union(8)

HISTORY
     An undelete function call first appeared in 4.4BSD -Lite.

BSD			       November 28, 2008			   BSD

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 

Vote for polarhome