2 * Server-side file descriptor management
4 * Copyright (C) 2000, 2003 Alexandre Julliard
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
33 #ifdef HAVE_SYS_POLL_H
38 #include <sys/types.h>
51 /* Because of the stupid Posix locking semantics, we need to keep
52 * track of all file descriptors referencing a given file, and not
53 * close a single one until all the locks are gone (sigh).
56 /* file descriptor object */
58 /* closed_fd is used to keep track of the unix fd belonging to a closed fd object */
61 struct list entry; /* entry in inode closed list */
62 int fd; /* the unix file descriptor */
63 char unlink[1]; /* name to unlink on close (if any) */
68 struct object obj; /* object header */
69 const struct fd_ops *fd_ops; /* file descriptor operations */
70 struct inode *inode; /* inode that this fd belongs to */
71 struct list inode_entry; /* entry in inode fd list */
72 struct closed_fd *closed; /* structure to store the unix fd at destroy time */
73 struct object *user; /* object using this file descriptor */
74 struct list locks; /* list of locks on this fd */
75 unsigned int access; /* file access (GENERIC_READ/WRITE) */
76 unsigned int sharing; /* file sharing mode */
77 int unix_fd; /* unix file descriptor */
78 int fs_locks; /* can we use filesystem locks for this fd? */
79 int poll_index; /* index of fd in poll array */
82 static void fd_dump( struct object *obj, int verbose );
83 static void fd_destroy( struct object *obj );
85 static const struct object_ops fd_ops =
87 sizeof(struct fd), /* size */
89 no_add_queue, /* add_queue */
90 NULL, /* remove_queue */
93 no_get_fd, /* get_fd */
94 fd_destroy /* destroy */
101 struct object obj; /* object header */
102 struct list entry; /* inode hash list entry */
103 unsigned int hash; /* hashing code */
104 dev_t dev; /* device number */
105 ino_t ino; /* inode number */
106 struct list open; /* list of open file descriptors */
107 struct list locks; /* list of file locks */
108 struct list closed; /* list of file descriptors to close at destroy time */
111 static void inode_dump( struct object *obj, int verbose );
112 static void inode_destroy( struct object *obj );
114 static const struct object_ops inode_ops =
116 sizeof(struct inode), /* size */
117 inode_dump, /* dump */
118 no_add_queue, /* add_queue */
119 NULL, /* remove_queue */
121 NULL, /* satisfied */
122 no_get_fd, /* get_fd */
123 inode_destroy /* destroy */
126 /* file lock object */
130 struct object obj; /* object header */
131 struct fd *fd; /* fd owning this lock */
132 struct list fd_entry; /* entry in list of locks on a given fd */
133 struct list inode_entry; /* entry in inode list of locks */
134 int shared; /* shared lock? */
135 file_pos_t start; /* locked region is interval [start;end) */
137 struct process *process; /* process owning this lock */
138 struct list proc_entry; /* entry in list of locks owned by the process */
141 static void file_lock_dump( struct object *obj, int verbose );
142 static int file_lock_signaled( struct object *obj, struct thread *thread );
144 static const struct object_ops file_lock_ops =
146 sizeof(struct file_lock), /* size */
147 file_lock_dump, /* dump */
148 add_queue, /* add_queue */
149 remove_queue, /* remove_queue */
150 file_lock_signaled, /* signaled */
151 no_satisfied, /* satisfied */
152 no_get_fd, /* get_fd */
153 no_destroy /* destroy */
157 #define OFF_T_MAX (~((file_pos_t)1 << (8*sizeof(off_t)-1)))
158 #define FILE_POS_T_MAX (~(file_pos_t)0)
160 static file_pos_t max_unix_offset = OFF_T_MAX;
162 #define DUMP_LONG_LONG(val) do { \
163 if (sizeof(val) > sizeof(unsigned long) && (val) > ~0UL) \
164 fprintf( stderr, "%lx%08lx", (unsigned long)((val) >> 32), (unsigned long)(val) ); \
166 fprintf( stderr, "%lx", (unsigned long)(val) ); \
171 /****************************************************************/
172 /* timeouts support */
176 struct timeout_user *next; /* next in sorted timeout list */
177 struct timeout_user *prev; /* prev in sorted timeout list */
178 struct timeval when; /* timeout expiry (absolute time) */
179 timeout_callback callback; /* callback function */
180 void *private; /* callback private data */
183 static struct timeout_user *timeout_head; /* sorted timeouts list head */
184 static struct timeout_user *timeout_tail; /* sorted timeouts list tail */
186 /* add a timeout user */
187 struct timeout_user *add_timeout_user( struct timeval *when, timeout_callback func, void *private )
189 struct timeout_user *user;
190 struct timeout_user *pos;
192 if (!(user = mem_alloc( sizeof(*user) ))) return NULL;
194 user->callback = func;
195 user->private = private;
197 /* Now insert it in the linked list */
199 for (pos = timeout_head; pos; pos = pos->next)
200 if (!time_before( &pos->when, when )) break;
202 if (pos) /* insert it before 'pos' */
204 if ((user->prev = pos->prev)) user->prev->next = user;
205 else timeout_head = user;
209 else /* insert it at the tail */
212 if (timeout_tail) timeout_tail->next = user;
213 else timeout_head = user;
214 user->prev = timeout_tail;
220 /* remove a timeout user */
221 void remove_timeout_user( struct timeout_user *user )
223 if (user->next) user->next->prev = user->prev;
224 else timeout_tail = user->prev;
225 if (user->prev) user->prev->next = user->next;
226 else timeout_head = user->next;
230 /* add a timeout in milliseconds to an absolute time */
231 void add_timeout( struct timeval *when, int timeout )
235 long sec = timeout / 1000;
236 if ((when->tv_usec += (timeout - 1000*sec) * 1000) >= 1000000)
238 when->tv_usec -= 1000000;
245 /* handle the next expired timeout */
246 inline static void handle_timeout(void)
248 struct timeout_user *user = timeout_head;
249 timeout_head = user->next;
250 if (user->next) user->next->prev = user->prev;
251 else timeout_tail = user->prev;
252 user->callback( user->private );
257 /****************************************************************/
260 static struct fd **poll_users; /* users array */
261 static struct pollfd *pollfd; /* poll fd array */
262 static int nb_users; /* count of array entries actually in use */
263 static int active_users; /* current number of active users */
264 static int allocated_users; /* count of allocated entries in the array */
265 static struct fd **freelist; /* list of free entries in the array */
267 /* add a user in the poll array and return its index, or -1 on failure */
268 static int add_poll_user( struct fd *fd )
273 ret = freelist - poll_users;
274 freelist = (struct fd **)poll_users[ret];
278 if (nb_users == allocated_users)
280 struct fd **newusers;
281 struct pollfd *newpoll;
282 int new_count = allocated_users ? (allocated_users + allocated_users / 2) : 16;
283 if (!(newusers = realloc( poll_users, new_count * sizeof(*poll_users) ))) return -1;
284 if (!(newpoll = realloc( pollfd, new_count * sizeof(*pollfd) )))
287 poll_users = newusers;
292 poll_users = newusers;
294 allocated_users = new_count;
299 pollfd[ret].events = 0;
300 pollfd[ret].revents = 0;
301 poll_users[ret] = fd;
306 /* remove a user from the poll list */
307 static void remove_poll_user( struct fd *fd, int user )
310 assert( poll_users[user] == fd );
311 pollfd[user].fd = -1;
312 pollfd[user].events = 0;
313 pollfd[user].revents = 0;
314 poll_users[user] = (struct fd *)freelist;
315 freelist = &poll_users[user];
320 /* server main poll() loop */
331 gettimeofday( &now, NULL );
334 if (!time_before( &now, &timeout_head->when )) handle_timeout();
337 diff = (timeout_head->when.tv_sec - now.tv_sec) * 1000
338 + (timeout_head->when.tv_usec - now.tv_usec) / 1000;
342 if (!active_users) break; /* last user removed by a timeout */
344 ret = poll( pollfd, nb_users, diff );
348 for (i = 0; i < nb_users; i++)
350 if (pollfd[i].revents)
352 fd_poll_event( poll_users[i], pollfd[i].revents );
361 /****************************************************************/
362 /* inode functions */
366 static struct list inode_hash[HASH_SIZE];
368 /* close all pending file descriptors in the closed list */
369 static void inode_close_pending( struct inode *inode )
371 struct list *ptr = list_head( &inode->closed );
375 struct closed_fd *fd = LIST_ENTRY( ptr, struct closed_fd, entry );
376 struct list *next = list_next( &inode->closed, ptr );
383 if (!fd->unlink) /* get rid of it unless there's an unlink pending on that file */
393 static void inode_dump( struct object *obj, int verbose )
395 struct inode *inode = (struct inode *)obj;
396 fprintf( stderr, "Inode dev=" );
397 DUMP_LONG_LONG( inode->dev );
398 fprintf( stderr, " ino=" );
399 DUMP_LONG_LONG( inode->ino );
400 fprintf( stderr, "\n" );
403 static void inode_destroy( struct object *obj )
405 struct inode *inode = (struct inode *)obj;
408 assert( list_empty(&inode->open) );
409 assert( list_empty(&inode->locks) );
411 list_remove( &inode->entry );
413 while ((ptr = list_head( &inode->closed )))
415 struct closed_fd *fd = LIST_ENTRY( ptr, struct closed_fd, entry );
417 if (fd->fd != -1) close( fd->fd );
420 /* make sure it is still the same file */
422 if (!stat( fd->unlink, &st ) && st.st_dev == inode->dev && st.st_ino == inode->ino)
424 if (S_ISDIR(st.st_mode)) rmdir( fd->unlink );
425 else unlink( fd->unlink );
432 /* retrieve the inode object for a given fd, creating it if needed */
433 static struct inode *get_inode( dev_t dev, ino_t ino )
437 unsigned int hash = (dev ^ ino) % HASH_SIZE;
439 if (inode_hash[hash].next)
441 LIST_FOR_EACH( ptr, &inode_hash[hash] )
443 inode = LIST_ENTRY( ptr, struct inode, entry );
444 if (inode->dev == dev && inode->ino == ino)
445 return (struct inode *)grab_object( inode );
448 else list_init( &inode_hash[hash] );
450 /* not found, create it */
451 if ((inode = alloc_object( &inode_ops )))
456 list_init( &inode->open );
457 list_init( &inode->locks );
458 list_init( &inode->closed );
459 list_add_head( &inode_hash[hash], &inode->entry );
464 /* add fd to the indoe list of file descriptors to close */
465 static void inode_add_closed_fd( struct inode *inode, struct closed_fd *fd )
467 if (!list_empty( &inode->locks ))
469 list_add_head( &inode->closed, &fd->entry );
471 else if (fd->unlink[0]) /* close the fd but keep the structure around for unlink */
475 list_add_head( &inode->closed, &fd->entry );
477 else /* no locks on this inode and no unlink, get rid of the fd */
485 /****************************************************************/
486 /* file lock functions */
488 static void file_lock_dump( struct object *obj, int verbose )
490 struct file_lock *lock = (struct file_lock *)obj;
491 fprintf( stderr, "Lock %s fd=%p proc=%p start=",
492 lock->shared ? "shared" : "excl", lock->fd, lock->process );
493 DUMP_LONG_LONG( lock->start );
494 fprintf( stderr, " end=" );
495 DUMP_LONG_LONG( lock->end );
496 fprintf( stderr, "\n" );
499 static int file_lock_signaled( struct object *obj, struct thread *thread )
501 struct file_lock *lock = (struct file_lock *)obj;
502 /* lock is signaled if it has lost its owner */
503 return !lock->process;
506 /* set (or remove) a Unix lock if possible for the given range */
507 static int set_unix_lock( struct fd *fd, file_pos_t start, file_pos_t end, int type )
511 if (!fd->fs_locks) return 1; /* no fs locks possible for this fd */
514 if (start == end) return 1; /* can't set zero-byte lock */
515 if (start > max_unix_offset) return 1; /* ignore it */
517 fl.l_whence = SEEK_SET;
519 if (!end || end > max_unix_offset) fl.l_len = 0;
520 else fl.l_len = end - start;
521 if (fcntl( fd->unix_fd, F_SETLK, &fl ) != -1) return 1;
526 /* check whether locks work at all on this file system */
527 if (fcntl( fd->unix_fd, F_GETLK, &fl ) != -1)
529 set_error( STATUS_FILE_LOCK_CONFLICT );
535 /* no locking on this fs, just ignore it */
539 set_error( STATUS_FILE_LOCK_CONFLICT );
542 /* this can happen if we try to set a write lock on a read-only file */
543 /* we just ignore that error */
544 if (fl.l_type == F_WRLCK) return 1;
545 set_error( STATUS_ACCESS_DENIED );
551 /* this can happen if off_t is 64-bit but the kernel only supports 32-bit */
552 /* in that case we shrink the limit and retry */
553 if (max_unix_offset > INT_MAX)
555 max_unix_offset = INT_MAX;
566 /* check if interval [start;end) overlaps the lock */
567 inline static int lock_overlaps( struct file_lock *lock, file_pos_t start, file_pos_t end )
569 if (lock->end && start >= lock->end) return 0;
570 if (end && lock->start >= end) return 0;
574 /* remove Unix locks for all bytes in the specified area that are no longer locked */
575 static void remove_unix_locks( struct fd *fd, file_pos_t start, file_pos_t end )
583 } *first, *cur, *next, *buffer;
588 if (!fd->inode) return;
589 if (!fd->fs_locks) return;
590 if (start == end || start > max_unix_offset) return;
591 if (!end || end > max_unix_offset) end = max_unix_offset + 1;
593 /* count the number of locks overlapping the specified area */
595 LIST_FOR_EACH( ptr, &fd->inode->locks )
597 struct file_lock *lock = LIST_ENTRY( ptr, struct file_lock, inode_entry );
598 if (lock->start == lock->end) continue;
599 if (lock_overlaps( lock, start, end )) count++;
602 if (!count) /* no locks at all, we can unlock everything */
604 set_unix_lock( fd, start, end, F_UNLCK );
608 /* allocate space for the list of holes */
609 /* max. number of holes is number of locks + 1 */
611 if (!(buffer = malloc( sizeof(*buffer) * (count+1) ))) return;
615 first->start = start;
619 /* build a sorted list of unlocked holes in the specified area */
621 LIST_FOR_EACH( ptr, &fd->inode->locks )
623 struct file_lock *lock = LIST_ENTRY( ptr, struct file_lock, inode_entry );
624 if (lock->start == lock->end) continue;
625 if (!lock_overlaps( lock, start, end )) continue;
627 /* go through all the holes touched by this lock */
628 for (cur = first; cur; cur = cur->next)
630 if (cur->end <= lock->start) continue; /* hole is before start of lock */
631 if (lock->end && cur->start >= lock->end) break; /* hole is after end of lock */
633 /* now we know that lock is overlapping hole */
635 if (cur->start >= lock->start) /* lock starts before hole, shrink from start */
637 cur->start = lock->end;
638 if (cur->start && cur->start < cur->end) break; /* done with this lock */
639 /* now hole is empty, remove it */
640 if (cur->next) cur->next->prev = cur->prev;
641 if (cur->prev) cur->prev->next = cur->next;
642 else if (!(first = cur->next)) goto done; /* no more holes at all */
644 else if (!lock->end || cur->end <= lock->end) /* lock larger than hole, shrink from end */
646 cur->end = lock->start;
647 assert( cur->start < cur->end );
649 else /* lock is in the middle of hole, split hole in two */
652 next->next = cur->next;
654 next->start = lock->end;
655 next->end = cur->end;
656 cur->end = lock->start;
657 assert( next->start < next->end );
658 assert( cur->end < next->start );
660 break; /* done with this lock */
665 /* clear Unix locks for all the holes */
667 for (cur = first; cur; cur = cur->next)
668 set_unix_lock( fd, cur->start, cur->end, F_UNLCK );
674 /* create a new lock on a fd */
675 static struct file_lock *add_lock( struct fd *fd, int shared, file_pos_t start, file_pos_t end )
677 struct file_lock *lock;
679 if (!fd->inode) /* not a regular file */
681 set_error( STATUS_INVALID_HANDLE );
685 if (!(lock = alloc_object( &file_lock_ops ))) return NULL;
686 lock->shared = shared;
690 lock->process = current->process;
692 /* now try to set a Unix lock */
693 if (!set_unix_lock( lock->fd, lock->start, lock->end, lock->shared ? F_RDLCK : F_WRLCK ))
695 release_object( lock );
698 list_add_head( &fd->locks, &lock->fd_entry );
699 list_add_head( &fd->inode->locks, &lock->inode_entry );
700 list_add_head( &lock->process->locks, &lock->proc_entry );
704 /* remove an existing lock */
705 static void remove_lock( struct file_lock *lock, int remove_unix )
707 struct inode *inode = lock->fd->inode;
709 list_remove( &lock->fd_entry );
710 list_remove( &lock->inode_entry );
711 list_remove( &lock->proc_entry );
712 if (remove_unix) remove_unix_locks( lock->fd, lock->start, lock->end );
713 if (list_empty( &inode->locks )) inode_close_pending( inode );
714 lock->process = NULL;
715 wake_up( &lock->obj, 0 );
716 release_object( lock );
719 /* remove all locks owned by a given process */
720 void remove_process_locks( struct process *process )
724 while ((ptr = list_head( &process->locks )))
726 struct file_lock *lock = LIST_ENTRY( ptr, struct file_lock, proc_entry );
727 remove_lock( lock, 1 ); /* this removes it from the list */
731 /* remove all locks on a given fd */
732 static void remove_fd_locks( struct fd *fd )
734 file_pos_t start = FILE_POS_T_MAX, end = 0;
737 while ((ptr = list_head( &fd->locks )))
739 struct file_lock *lock = LIST_ENTRY( ptr, struct file_lock, fd_entry );
740 if (lock->start < start) start = lock->start;
741 if (!lock->end || lock->end > end) end = lock->end - 1;
742 remove_lock( lock, 0 );
744 if (start < end) remove_unix_locks( fd, start, end + 1 );
747 /* add a lock on an fd */
748 /* returns handle to wait on */
749 obj_handle_t lock_fd( struct fd *fd, file_pos_t start, file_pos_t count, int shared, int wait )
752 file_pos_t end = start + count;
754 /* don't allow wrapping locks */
755 if (end && end < start)
757 set_error( STATUS_INVALID_PARAMETER );
761 /* check if another lock on that file overlaps the area */
762 LIST_FOR_EACH( ptr, &fd->inode->locks )
764 struct file_lock *lock = LIST_ENTRY( ptr, struct file_lock, inode_entry );
765 if (!lock_overlaps( lock, start, end )) continue;
766 if (lock->shared && shared) continue;
770 set_error( STATUS_FILE_LOCK_CONFLICT );
773 set_error( STATUS_PENDING );
774 return alloc_handle( current->process, lock, SYNCHRONIZE, 0 );
777 /* not found, add it */
778 if (add_lock( fd, shared, start, end )) return 0;
779 if (get_error() == STATUS_FILE_LOCK_CONFLICT)
781 /* Unix lock conflict -> tell client to wait and retry */
782 if (wait) set_error( STATUS_PENDING );
787 /* remove a lock on an fd */
788 void unlock_fd( struct fd *fd, file_pos_t start, file_pos_t count )
791 file_pos_t end = start + count;
793 /* find an existing lock with the exact same parameters */
794 LIST_FOR_EACH( ptr, &fd->locks )
796 struct file_lock *lock = LIST_ENTRY( ptr, struct file_lock, fd_entry );
797 if ((lock->start == start) && (lock->end == end))
799 remove_lock( lock, 1 );
803 set_error( STATUS_FILE_LOCK_CONFLICT );
807 /****************************************************************/
808 /* file descriptor functions */
810 static void fd_dump( struct object *obj, int verbose )
812 struct fd *fd = (struct fd *)obj;
813 fprintf( stderr, "Fd unix_fd=%d user=%p unlink='%s'\n",
814 fd->unix_fd, fd->user, fd->closed->unlink );
817 static void fd_destroy( struct object *obj )
819 struct fd *fd = (struct fd *)obj;
821 remove_fd_locks( fd );
822 list_remove( &fd->inode_entry );
823 if (fd->poll_index != -1) remove_poll_user( fd, fd->poll_index );
826 inode_add_closed_fd( fd->inode, fd->closed );
827 release_object( fd->inode );
829 else /* no inode, close it right away */
831 if (fd->unix_fd != -1) close( fd->unix_fd );
835 /* set the events that select waits for on this fd */
836 void set_fd_events( struct fd *fd, int events )
838 int user = fd->poll_index;
839 assert( poll_users[user] == fd );
840 if (events == -1) /* stop waiting on this fd completely */
842 pollfd[user].fd = -1;
843 pollfd[user].events = POLLERR;
844 pollfd[user].revents = 0;
846 else if (pollfd[user].fd != -1 || !pollfd[user].events)
848 pollfd[user].fd = fd->unix_fd;
849 pollfd[user].events = events;
853 /* allocate an fd object, without setting the unix fd yet */
854 struct fd *alloc_fd( const struct fd_ops *fd_user_ops, struct object *user )
856 struct fd *fd = alloc_object( &fd_ops );
858 if (!fd) return NULL;
860 fd->fd_ops = fd_user_ops;
869 list_init( &fd->inode_entry );
870 list_init( &fd->locks );
872 if ((fd->poll_index = add_poll_user( fd )) == -1)
874 release_object( fd );
880 /* check if the desired access is possible without violating */
881 /* the sharing mode of other opens of the same file */
882 static int check_sharing( struct fd *fd, unsigned int access, unsigned int sharing )
884 unsigned int existing_sharing = FILE_SHARE_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE;
885 unsigned int existing_access = 0;
889 /* if access mode is 0, sharing mode is ignored */
890 if (!access) sharing = existing_sharing;
892 fd->sharing = sharing;
894 LIST_FOR_EACH( ptr, &fd->inode->open )
896 struct fd *fd_ptr = LIST_ENTRY( ptr, struct fd, inode_entry );
899 existing_sharing &= fd_ptr->sharing;
900 existing_access |= fd_ptr->access;
901 if (fd_ptr->closed->unlink[0]) unlink = 1;
905 if ((access & GENERIC_READ) && !(existing_sharing & FILE_SHARE_READ)) return 0;
906 if ((access & GENERIC_WRITE) && !(existing_sharing & FILE_SHARE_WRITE)) return 0;
907 if ((existing_access & GENERIC_READ) && !(sharing & FILE_SHARE_READ)) return 0;
908 if ((existing_access & GENERIC_WRITE) && !(sharing & FILE_SHARE_WRITE)) return 0;
909 if (fd->closed->unlink[0] && !(existing_sharing & FILE_SHARE_DELETE)) return 0;
910 if (unlink && !(sharing & FILE_SHARE_DELETE)) return 0;
914 /* open() wrapper using a struct fd */
915 /* the fd must have been created with alloc_fd */
916 /* on error the fd object is released */
917 struct fd *open_fd( struct fd *fd, const char *name, int flags, mode_t *mode,
918 unsigned int access, unsigned int sharing, unsigned int options )
921 struct closed_fd *closed_fd;
922 const char *unlink_name = "";
924 assert( fd->unix_fd == -1 );
926 if (options & FILE_DELETE_ON_CLOSE) unlink_name = name;
927 if (!(closed_fd = mem_alloc( sizeof(*closed_fd) + strlen(unlink_name) )))
929 release_object( fd );
932 /* create the directory if needed */
933 if ((options & FILE_DIRECTORY_FILE) && (flags & O_CREAT))
935 if (mkdir( name, 0777 ) == -1)
937 if (errno != EEXIST || (flags & O_EXCL))
940 release_object( fd );
945 flags &= ~(O_CREAT | O_EXCL | O_TRUNC);
947 if ((fd->unix_fd = open( name, flags & ~O_TRUNC, *mode )) == -1)
950 release_object( fd );
954 closed_fd->fd = fd->unix_fd;
955 closed_fd->unlink[0] = 0;
956 fstat( fd->unix_fd, &st );
959 /* check directory options */
960 if ((options & FILE_DIRECTORY_FILE) && !S_ISDIR(st.st_mode))
962 set_error( STATUS_NOT_A_DIRECTORY );
965 if ((options & FILE_NON_DIRECTORY_FILE) && S_ISDIR(st.st_mode))
967 set_error( STATUS_FILE_IS_A_DIRECTORY );
971 /* only bother with an inode for normal files and directories */
972 if (S_ISREG(st.st_mode) || S_ISDIR(st.st_mode))
974 struct inode *inode = get_inode( st.st_dev, st.st_ino );
978 /* we can close the fd because there are no others open on the same file,
979 * otherwise we wouldn't have failed to allocate a new inode
984 fd->closed = closed_fd;
985 list_add_head( &inode->open, &fd->inode_entry );
986 if (!check_sharing( fd, access, sharing ))
988 release_object( fd );
989 set_error( STATUS_SHARING_VIOLATION );
992 strcpy( closed_fd->unlink, unlink_name );
993 if (flags & O_TRUNC) ftruncate( fd->unix_fd, 0 );
997 if (unlink_name[0]) /* we can't unlink special files */
999 set_error( STATUS_INVALID_PARAMETER );
1007 release_object( fd );
1012 /* create an fd for an anonymous file */
1013 /* if the function fails the unix fd is closed */
1014 struct fd *create_anonymous_fd( const struct fd_ops *fd_user_ops, int unix_fd, struct object *user )
1016 struct fd *fd = alloc_fd( fd_user_ops, user );
1020 fd->unix_fd = unix_fd;
1027 /* retrieve the object that is using an fd */
1028 void *get_fd_user( struct fd *fd )
1033 /* retrieve the unix fd for an object */
1034 int get_unix_fd( struct fd *fd )
1039 /* check if two file descriptors point to the same file */
1040 int is_same_file_fd( struct fd *fd1, struct fd *fd2 )
1042 return fd1->inode == fd2->inode;
1045 /* callback for event happening in the main poll() loop */
1046 void fd_poll_event( struct fd *fd, int event )
1048 return fd->fd_ops->poll_event( fd, event );
1051 /* check if events are pending and if yes return which one(s) */
1052 int check_fd_events( struct fd *fd, int events )
1056 pfd.fd = fd->unix_fd;
1057 pfd.events = events;
1058 if (poll( &pfd, 1, 0 ) <= 0) return 0;
1062 /* default add_queue() routine for objects that poll() on an fd */
1063 int default_fd_add_queue( struct object *obj, struct wait_queue_entry *entry )
1065 struct fd *fd = get_obj_fd( obj );
1068 if (!obj->head) /* first on the queue */
1069 set_fd_events( fd, fd->fd_ops->get_poll_events( fd ) );
1070 add_queue( obj, entry );
1071 release_object( fd );
1075 /* default remove_queue() routine for objects that poll() on an fd */
1076 void default_fd_remove_queue( struct object *obj, struct wait_queue_entry *entry )
1078 struct fd *fd = get_obj_fd( obj );
1081 remove_queue( obj, entry );
1082 if (!obj->head) /* last on the queue is gone */
1083 set_fd_events( fd, 0 );
1084 release_object( obj );
1085 release_object( fd );
1088 /* default signaled() routine for objects that poll() on an fd */
1089 int default_fd_signaled( struct object *obj, struct thread *thread )
1091 struct fd *fd = get_obj_fd( obj );
1092 int events = fd->fd_ops->get_poll_events( fd );
1093 int ret = check_fd_events( fd, events ) != 0;
1096 set_fd_events( fd, 0 ); /* stop waiting on select() if we are signaled */
1098 set_fd_events( fd, events ); /* restart waiting on poll() if we are no longer signaled */
1100 release_object( fd );
1104 /* default handler for poll() events */
1105 void default_poll_event( struct fd *fd, int event )
1107 /* an error occurred, stop polling this fd to avoid busy-looping */
1108 if (event & (POLLERR | POLLHUP)) set_fd_events( fd, -1 );
1109 wake_up( fd->user, 0 );
1112 /* default flush() routine */
1113 int no_flush( struct fd *fd, struct event **event )
1115 set_error( STATUS_OBJECT_TYPE_MISMATCH );
1119 /* default get_file_info() routine */
1120 int no_get_file_info( struct fd *fd )
1122 set_error( STATUS_OBJECT_TYPE_MISMATCH );
1126 /* default queue_async() routine */
1127 void no_queue_async( struct fd *fd, void* ptr, unsigned int status, int type, int count )
1129 set_error( STATUS_OBJECT_TYPE_MISMATCH );
1132 /* same as get_handle_obj but retrieve the struct fd associated to the object */
1133 static struct fd *get_handle_fd_obj( struct process *process, obj_handle_t handle,
1134 unsigned int access )
1136 struct fd *fd = NULL;
1139 if ((obj = get_handle_obj( process, handle, access, NULL )))
1141 fd = get_obj_fd( obj );
1142 release_object( obj );
1147 /* flush a file buffers */
1148 DECL_HANDLER(flush_file)
1150 struct fd *fd = get_handle_fd_obj( current->process, req->handle, 0 );
1151 struct event * event = NULL;
1155 fd->fd_ops->flush( fd, &event );
1158 reply->event = alloc_handle( current->process, event, SYNCHRONIZE, 0 );
1160 release_object( fd );
1164 /* get a Unix fd to access a file */
1165 DECL_HANDLER(get_handle_fd)
1171 if ((fd = get_handle_fd_obj( current->process, req->handle, req->access )))
1173 int unix_fd = get_handle_unix_fd( current->process, req->handle, req->access );
1174 if (unix_fd != -1) reply->fd = unix_fd;
1175 else if (!get_error())
1177 assert( fd->unix_fd != -1 );
1178 send_client_fd( current->process, fd->unix_fd, req->handle );
1180 reply->flags = fd->fd_ops->get_file_info( fd );
1181 release_object( fd );
1185 /* create / reschedule an async I/O */
1186 DECL_HANDLER(register_async)
1188 struct fd *fd = get_handle_fd_obj( current->process, req->handle, 0 );
1191 * The queue_async method must do the following:
1193 * 1. Get the async_queue for the request of given type.
1194 * 2. Call find_async() to look for the specific client request in the queue (=> NULL if not found).
1195 * 3. If status is STATUS_PENDING:
1196 * a) If no async request found in step 2 (new request): call create_async() to initialize one.
1197 * b) Set request's status to STATUS_PENDING.
1198 * c) If the "queue" field of the async request is NULL: call async_insert() to put it into the queue.
1200 * If the async request was found in step 2, destroy it by calling destroy_async().
1201 * 4. Carry out any operations necessary to adjust the object's poll events
1202 * Usually: set_elect_events (obj, obj->ops->get_poll_events()).
1204 * See also the implementations in file.c, serial.c, and sock.c.
1209 fd->fd_ops->queue_async( fd, req->overlapped, req->status, req->type, req->count );
1210 release_object( fd );