2 * Server-side device support
4 * Copyright (C) 2007 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., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
22 #include "wine/port.h"
31 #define WIN32_NO_STATUS
46 struct object obj
; /* object header */
47 struct list dev_entry
; /* entry in device queue */
48 struct list mgr_entry
; /* entry in manager queue */
49 struct device_file
*file
; /* file containing this irp */
50 struct thread
*thread
; /* thread that queued the irp */
51 client_ptr_t user_arg
; /* user arg used to identify the request */
52 struct async
*async
; /* pending async op */
53 irp_params_t params
; /* irp parameters */
54 struct iosb
*iosb
; /* I/O status block */
57 static void irp_call_dump( struct object
*obj
, int verbose
);
58 static int irp_call_signaled( struct object
*obj
, struct wait_queue_entry
*entry
);
59 static void irp_call_destroy( struct object
*obj
);
61 static const struct object_ops irp_call_ops
=
63 sizeof(struct irp_call
), /* size */
64 irp_call_dump
, /* dump */
65 no_get_type
, /* get_type */
66 add_queue
, /* add_queue */
67 remove_queue
, /* remove_queue */
68 irp_call_signaled
, /* signaled */
69 no_satisfied
, /* satisfied */
70 no_signal
, /* signal */
71 no_get_fd
, /* get_fd */
72 no_map_access
, /* map_access */
73 default_get_sd
, /* get_sd */
74 default_set_sd
, /* set_sd */
75 no_lookup_name
, /* lookup_name */
76 no_link_name
, /* link_name */
77 NULL
, /* unlink_name */
78 no_open_file
, /* open_file */
79 no_close_handle
, /* close_handle */
80 irp_call_destroy
/* destroy */
84 /* device manager (a list of devices managed by the same client process) */
88 struct object obj
; /* object header */
89 struct list devices
; /* list of devices */
90 struct list requests
; /* list of pending irps across all devices */
93 static void device_manager_dump( struct object
*obj
, int verbose
);
94 static int device_manager_signaled( struct object
*obj
, struct wait_queue_entry
*entry
);
95 static void device_manager_destroy( struct object
*obj
);
97 static const struct object_ops device_manager_ops
=
99 sizeof(struct device_manager
), /* size */
100 device_manager_dump
, /* dump */
101 no_get_type
, /* get_type */
102 add_queue
, /* add_queue */
103 remove_queue
, /* remove_queue */
104 device_manager_signaled
, /* signaled */
105 no_satisfied
, /* satisfied */
106 no_signal
, /* signal */
107 no_get_fd
, /* get_fd */
108 no_map_access
, /* map_access */
109 default_get_sd
, /* get_sd */
110 default_set_sd
, /* set_sd */
111 no_lookup_name
, /* lookup_name */
112 no_link_name
, /* link_name */
113 NULL
, /* unlink_name */
114 no_open_file
, /* open_file */
115 no_close_handle
, /* close_handle */
116 device_manager_destroy
/* destroy */
120 /* device (a single device object) */
124 struct object obj
; /* object header */
125 struct device_manager
*manager
; /* manager for this device (or NULL if deleted) */
126 char *unix_path
; /* path to unix device if any */
127 client_ptr_t user_ptr
; /* opaque ptr for client side */
128 struct list entry
; /* entry in device manager list */
129 struct list files
; /* list of open files */
132 static void device_dump( struct object
*obj
, int verbose
);
133 static struct object_type
*device_get_type( struct object
*obj
);
134 static void device_destroy( struct object
*obj
);
135 static struct object
*device_open_file( struct object
*obj
, unsigned int access
,
136 unsigned int sharing
, unsigned int options
);
138 static const struct object_ops device_ops
=
140 sizeof(struct device
), /* size */
141 device_dump
, /* dump */
142 device_get_type
, /* get_type */
143 no_add_queue
, /* add_queue */
144 NULL
, /* remove_queue */
146 no_satisfied
, /* satisfied */
147 no_signal
, /* signal */
148 no_get_fd
, /* get_fd */
149 default_fd_map_access
, /* map_access */
150 default_get_sd
, /* get_sd */
151 default_set_sd
, /* set_sd */
152 no_lookup_name
, /* lookup_name */
153 directory_link_name
, /* link_name */
154 default_unlink_name
, /* unlink_name */
155 device_open_file
, /* open_file */
156 no_close_handle
, /* close_handle */
157 device_destroy
/* destroy */
161 /* device file (an open file handle to a device) */
165 struct object obj
; /* object header */
166 struct device
*device
; /* device for this file */
167 struct fd
*fd
; /* file descriptor for irp */
168 client_ptr_t user_ptr
; /* opaque ptr for client side */
169 struct list entry
; /* entry in device list */
170 struct list requests
; /* list of pending irp requests */
173 static void device_file_dump( struct object
*obj
, int verbose
);
174 static struct fd
*device_file_get_fd( struct object
*obj
);
175 static int device_file_close_handle( struct object
*obj
, struct process
*process
, obj_handle_t handle
);
176 static void device_file_destroy( struct object
*obj
);
177 static enum server_fd_type
device_file_get_fd_type( struct fd
*fd
);
178 static obj_handle_t
device_file_read( struct fd
*fd
, const async_data_t
*async_data
, int blocking
,
180 static obj_handle_t
device_file_write( struct fd
*fd
, const async_data_t
*async_data
, int blocking
,
181 file_pos_t pos
, data_size_t
*written
);
182 static obj_handle_t
device_file_flush( struct fd
*fd
, const async_data_t
*async_data
, int blocking
);
183 static obj_handle_t
device_file_ioctl( struct fd
*fd
, ioctl_code_t code
, const async_data_t
*async_data
,
186 static const struct object_ops device_file_ops
=
188 sizeof(struct device_file
), /* size */
189 device_file_dump
, /* dump */
190 no_get_type
, /* get_type */
191 add_queue
, /* add_queue */
192 remove_queue
, /* remove_queue */
193 default_fd_signaled
, /* signaled */
194 no_satisfied
, /* satisfied */
195 no_signal
, /* signal */
196 device_file_get_fd
, /* get_fd */
197 default_fd_map_access
, /* map_access */
198 default_get_sd
, /* get_sd */
199 default_set_sd
, /* set_sd */
200 no_lookup_name
, /* lookup_name */
201 no_link_name
, /* link_name */
202 NULL
, /* unlink_name */
203 no_open_file
, /* open_file */
204 device_file_close_handle
, /* close_handle */
205 device_file_destroy
/* destroy */
208 static const struct fd_ops device_file_fd_ops
=
210 default_fd_get_poll_events
, /* get_poll_events */
211 default_poll_event
, /* poll_event */
212 device_file_get_fd_type
, /* get_fd_type */
213 device_file_read
, /* read */
214 device_file_write
, /* write */
215 device_file_flush
, /* flush */
216 device_file_ioctl
, /* ioctl */
217 default_fd_queue_async
, /* queue_async */
218 default_fd_reselect_async
/* reselect_async */
222 static void irp_call_dump( struct object
*obj
, int verbose
)
224 struct irp_call
*irp
= (struct irp_call
*)obj
;
225 fprintf( stderr
, "IRP call file=%p\n", irp
->file
);
228 static int irp_call_signaled( struct object
*obj
, struct wait_queue_entry
*entry
)
230 struct irp_call
*irp
= (struct irp_call
*)obj
;
232 return !irp
->file
; /* file is cleared once the irp has completed */
235 static void irp_call_destroy( struct object
*obj
)
237 struct irp_call
*irp
= (struct irp_call
*)obj
;
241 async_terminate( irp
->async
, STATUS_CANCELLED
);
242 release_object( irp
->async
);
244 if (irp
->iosb
) release_object( irp
->iosb
);
245 if (irp
->file
) release_object( irp
->file
);
246 if (irp
->thread
) release_object( irp
->thread
);
249 static struct irp_call
*create_irp( struct device_file
*file
, const irp_params_t
*params
,
250 const void *in_data
, data_size_t in_size
, data_size_t out_size
)
252 struct irp_call
*irp
;
254 if (!file
->device
->manager
) /* it has been deleted */
256 set_error( STATUS_FILE_DELETED
);
260 if ((irp
= alloc_object( &irp_call_ops
)))
262 irp
->file
= (struct device_file
*)grab_object( file
);
265 irp
->params
= *params
;
267 if (!(irp
->iosb
= create_iosb( in_data
, in_size
, out_size
)))
269 release_object( irp
);
276 static void set_irp_result( struct irp_call
*irp
, unsigned int status
,
277 const void *out_data
, data_size_t out_size
, data_size_t result
)
279 struct device_file
*file
= irp
->file
;
280 struct iosb
*iosb
= irp
->iosb
;
282 if (!file
) return; /* already finished */
284 /* FIXME: handle the STATUS_PENDING case */
285 iosb
->status
= status
;
286 iosb
->result
= result
;
287 iosb
->out_size
= min( iosb
->out_size
, out_size
);
288 if (iosb
->out_size
&& !(iosb
->out_data
= memdup( out_data
, iosb
->out_size
)))
293 if (result
) status
= STATUS_ALERTED
;
294 async_terminate( irp
->async
, status
);
295 release_object( irp
->async
);
298 wake_up( &irp
->obj
, 0 );
300 /* remove it from the device queue */
301 list_remove( &irp
->dev_entry
);
302 release_object( irp
); /* no longer on the device queue */
303 release_object( file
);
307 static void device_dump( struct object
*obj
, int verbose
)
309 fputs( "Device\n", stderr
);
312 static struct object_type
*device_get_type( struct object
*obj
)
314 static const WCHAR name
[] = {'D','e','v','i','c','e'};
315 static const struct unicode_str str
= { name
, sizeof(name
) };
316 return get_object_type( &str
);
319 static void device_destroy( struct object
*obj
)
321 struct device
*device
= (struct device
*)obj
;
323 assert( list_empty( &device
->files
));
325 free( device
->unix_path
);
326 if (device
->manager
) list_remove( &device
->entry
);
329 static void add_irp_to_queue( struct device_file
*file
, struct irp_call
*irp
, struct thread
*thread
)
331 struct device_manager
*manager
= file
->device
->manager
;
335 grab_object( irp
); /* grab reference for queued irp */
336 irp
->thread
= thread
? (struct thread
*)grab_object( thread
) : NULL
;
337 list_add_tail( &file
->requests
, &irp
->dev_entry
);
338 list_add_tail( &manager
->requests
, &irp
->mgr_entry
);
339 if (list_head( &manager
->requests
) == &irp
->mgr_entry
) wake_up( &manager
->obj
, 0 ); /* first one */
342 static struct object
*device_open_file( struct object
*obj
, unsigned int access
,
343 unsigned int sharing
, unsigned int options
)
345 struct device
*device
= (struct device
*)obj
;
346 struct device_file
*file
;
348 if (!(file
= alloc_object( &device_file_ops
))) return NULL
;
350 file
->device
= (struct device
*)grab_object( device
);
352 list_init( &file
->requests
);
353 list_add_tail( &device
->files
, &file
->entry
);
354 if (device
->unix_path
)
357 access
= file
->obj
.ops
->map_access( &file
->obj
, access
);
358 file
->fd
= open_fd( NULL
, device
->unix_path
, O_NONBLOCK
| O_LARGEFILE
,
359 &mode
, access
, sharing
, options
);
360 if (file
->fd
) set_fd_user( file
->fd
, &device_file_fd_ops
, &file
->obj
);
362 else file
->fd
= alloc_pseudo_fd( &device_file_fd_ops
, &file
->obj
, 0 );
366 release_object( file
);
370 allow_fd_caching( file
->fd
);
374 struct irp_call
*irp
;
377 memset( ¶ms
, 0, sizeof(params
) );
378 params
.create
.major
= IRP_MJ_CREATE
;
379 params
.create
.access
= access
;
380 params
.create
.sharing
= sharing
;
381 params
.create
.options
= options
;
382 params
.create
.device
= file
->device
->user_ptr
;
384 if ((irp
= create_irp( file
, ¶ms
, NULL
, 0, 0 )))
386 add_irp_to_queue( file
, irp
, NULL
);
387 release_object( irp
);
393 static void device_file_dump( struct object
*obj
, int verbose
)
395 struct device_file
*file
= (struct device_file
*)obj
;
397 fprintf( stderr
, "File on device %p\n", file
->device
);
400 static struct fd
*device_file_get_fd( struct object
*obj
)
402 struct device_file
*file
= (struct device_file
*)obj
;
404 return (struct fd
*)grab_object( file
->fd
);
407 static int device_file_close_handle( struct object
*obj
, struct process
*process
, obj_handle_t handle
)
409 struct device_file
*file
= (struct device_file
*)obj
;
411 if (file
->device
->manager
&& obj
->handle_count
== 1) /* last handle */
413 struct irp_call
*irp
;
416 memset( ¶ms
, 0, sizeof(params
) );
417 params
.close
.major
= IRP_MJ_CLOSE
;
418 params
.close
.file
= file
->user_ptr
;
420 if ((irp
= create_irp( file
, ¶ms
, NULL
, 0, 0 )))
422 add_irp_to_queue( file
, irp
, NULL
);
423 release_object( irp
);
429 static void device_file_destroy( struct object
*obj
)
431 struct device_file
*file
= (struct device_file
*)obj
;
432 struct irp_call
*irp
, *next
;
434 LIST_FOR_EACH_ENTRY_SAFE( irp
, next
, &file
->requests
, struct irp_call
, dev_entry
)
436 list_remove( &irp
->dev_entry
);
437 release_object( irp
); /* no longer on the device queue */
439 if (file
->fd
) release_object( file
->fd
);
440 list_remove( &file
->entry
);
441 release_object( file
->device
);
444 static void set_file_user_ptr( struct device_file
*file
, client_ptr_t ptr
)
446 struct irp_call
*irp
;
448 if (file
->user_ptr
== ptr
) return; /* nothing to do */
450 file
->user_ptr
= ptr
;
452 /* update already queued irps */
454 LIST_FOR_EACH_ENTRY( irp
, &file
->requests
, struct irp_call
, dev_entry
)
456 switch (irp
->params
.major
)
458 case IRP_MJ_CLOSE
: irp
->params
.close
.file
= ptr
; break;
459 case IRP_MJ_READ
: irp
->params
.read
.file
= ptr
; break;
460 case IRP_MJ_WRITE
: irp
->params
.write
.file
= ptr
; break;
461 case IRP_MJ_FLUSH_BUFFERS
: irp
->params
.flush
.file
= ptr
; break;
462 case IRP_MJ_DEVICE_CONTROL
: irp
->params
.ioctl
.file
= ptr
; break;
467 /* queue an irp to the device */
468 static obj_handle_t
queue_irp( struct device_file
*file
, struct irp_call
*irp
,
469 const async_data_t
*async_data
, int blocking
)
471 obj_handle_t handle
= 0;
473 if (blocking
&& !(handle
= alloc_handle( current
->process
, irp
, SYNCHRONIZE
, 0 ))) return 0;
475 if (!(irp
->async
= fd_queue_async( file
->fd
, async_data
, irp
->iosb
, ASYNC_TYPE_WAIT
)))
477 if (handle
) close_handle( current
->process
, handle
);
480 irp
->user_arg
= async_data
->arg
;
481 add_irp_to_queue( file
, irp
, current
);
482 set_error( STATUS_PENDING
);
486 static enum server_fd_type
device_file_get_fd_type( struct fd
*fd
)
488 return FD_TYPE_DEVICE
;
491 static obj_handle_t
device_file_read( struct fd
*fd
, const async_data_t
*async_data
, int blocking
,
494 struct device_file
*file
= get_fd_user( fd
);
495 struct irp_call
*irp
;
499 memset( ¶ms
, 0, sizeof(params
) );
500 params
.read
.major
= IRP_MJ_READ
;
502 params
.read
.pos
= pos
;
503 params
.read
.file
= file
->user_ptr
;
505 irp
= create_irp( file
, ¶ms
, NULL
, 0, get_reply_max_size() );
508 handle
= queue_irp( file
, irp
, async_data
, blocking
);
509 release_object( irp
);
513 static obj_handle_t
device_file_write( struct fd
*fd
, const async_data_t
*async_data
, int blocking
,
514 file_pos_t pos
, data_size_t
*written
)
516 struct device_file
*file
= get_fd_user( fd
);
517 struct irp_call
*irp
;
521 memset( ¶ms
, 0, sizeof(params
) );
522 params
.write
.major
= IRP_MJ_WRITE
;
523 params
.write
.key
= 0;
524 params
.write
.pos
= pos
;
525 params
.write
.file
= file
->user_ptr
;
527 irp
= create_irp( file
, ¶ms
, get_req_data(), get_req_data_size(), 0 );
530 handle
= queue_irp( file
, irp
, async_data
, blocking
);
531 release_object( irp
);
535 static obj_handle_t
device_file_flush( struct fd
*fd
, const async_data_t
*async_data
, int blocking
)
537 struct device_file
*file
= get_fd_user( fd
);
538 struct irp_call
*irp
;
542 memset( ¶ms
, 0, sizeof(params
) );
543 params
.flush
.major
= IRP_MJ_FLUSH_BUFFERS
;
544 params
.flush
.file
= file
->user_ptr
;
546 irp
= create_irp( file
, ¶ms
, NULL
, 0, 0 );
549 handle
= queue_irp( file
, irp
, async_data
, blocking
);
550 release_object( irp
);
554 static obj_handle_t
device_file_ioctl( struct fd
*fd
, ioctl_code_t code
, const async_data_t
*async_data
,
557 struct device_file
*file
= get_fd_user( fd
);
558 struct irp_call
*irp
;
562 memset( ¶ms
, 0, sizeof(params
) );
563 params
.ioctl
.major
= IRP_MJ_DEVICE_CONTROL
;
564 params
.ioctl
.code
= code
;
565 params
.ioctl
.file
= file
->user_ptr
;
567 irp
= create_irp( file
, ¶ms
, get_req_data(), get_req_data_size(),
568 get_reply_max_size() );
571 handle
= queue_irp( file
, irp
, async_data
, blocking
);
572 release_object( irp
);
576 static struct device
*create_device( struct object
*root
, const struct unicode_str
*name
,
577 struct device_manager
*manager
, unsigned int attr
)
579 struct device
*device
;
581 if ((device
= create_named_object( root
, &device_ops
, name
, attr
, NULL
)))
583 if (get_error() != STATUS_OBJECT_NAME_EXISTS
)
585 /* initialize it if it didn't already exist */
586 device
->unix_path
= NULL
;
587 device
->manager
= manager
;
588 list_add_tail( &manager
->devices
, &device
->entry
);
589 list_init( &device
->files
);
595 struct object
*create_unix_device( struct object
*root
, const struct unicode_str
*name
,
596 const char *unix_path
)
598 struct device
*device
;
600 if ((device
= create_named_object( root
, &device_ops
, name
, 0, NULL
)))
602 device
->unix_path
= strdup( unix_path
);
603 device
->manager
= NULL
; /* no manager, requests go straight to the Unix device */
604 list_init( &device
->files
);
610 /* terminate requests when the underlying device is deleted */
611 static void delete_file( struct device_file
*file
)
613 struct irp_call
*irp
, *next
;
615 /* terminate all pending requests */
616 LIST_FOR_EACH_ENTRY_SAFE( irp
, next
, &file
->requests
, struct irp_call
, dev_entry
)
618 list_remove( &irp
->mgr_entry
);
619 set_irp_result( irp
, STATUS_FILE_DELETED
, NULL
, 0, 0 );
623 static void delete_device( struct device
*device
)
625 struct device_file
*file
, *next
;
627 if (!device
->manager
) return; /* already deleted */
629 LIST_FOR_EACH_ENTRY_SAFE( file
, next
, &device
->files
, struct device_file
, entry
)
632 unlink_named_object( &device
->obj
);
633 list_remove( &device
->entry
);
634 device
->manager
= NULL
;
638 static void device_manager_dump( struct object
*obj
, int verbose
)
640 fprintf( stderr
, "Device manager\n" );
643 static int device_manager_signaled( struct object
*obj
, struct wait_queue_entry
*entry
)
645 struct device_manager
*manager
= (struct device_manager
*)obj
;
647 return !list_empty( &manager
->requests
);
650 static void device_manager_destroy( struct object
*obj
)
652 struct device_manager
*manager
= (struct device_manager
*)obj
;
655 while ((ptr
= list_head( &manager
->devices
)))
657 struct device
*device
= LIST_ENTRY( ptr
, struct device
, entry
);
658 delete_device( device
);
662 static struct device_manager
*create_device_manager(void)
664 struct device_manager
*manager
;
666 if ((manager
= alloc_object( &device_manager_ops
)))
668 list_init( &manager
->devices
);
669 list_init( &manager
->requests
);
675 /* create a device manager */
676 DECL_HANDLER(create_device_manager
)
678 struct device_manager
*manager
= create_device_manager();
682 reply
->handle
= alloc_handle( current
->process
, manager
, req
->access
, req
->attributes
);
683 release_object( manager
);
688 /* create a device */
689 DECL_HANDLER(create_device
)
691 struct device
*device
;
692 struct unicode_str name
= get_req_unicode_str();
693 struct device_manager
*manager
;
694 struct object
*root
= NULL
;
696 if (!(manager
= (struct device_manager
*)get_handle_obj( current
->process
, req
->manager
,
697 0, &device_manager_ops
)))
700 if (req
->rootdir
&& !(root
= get_directory_obj( current
->process
, req
->rootdir
)))
702 release_object( manager
);
706 if ((device
= create_device( root
, &name
, manager
, req
->attributes
)))
708 device
->user_ptr
= req
->user_ptr
;
709 reply
->handle
= alloc_handle( current
->process
, device
, req
->access
, req
->attributes
);
710 release_object( device
);
713 if (root
) release_object( root
);
714 release_object( manager
);
718 /* delete a device */
719 DECL_HANDLER(delete_device
)
721 struct device
*device
;
723 if ((device
= (struct device
*)get_handle_obj( current
->process
, req
->handle
, 0, &device_ops
)))
725 delete_device( device
);
726 release_object( device
);
731 /* retrieve the next pending device irp request */
732 DECL_HANDLER(get_next_device_request
)
734 struct irp_call
*irp
;
735 struct device_manager
*manager
;
739 reply
->params
.major
= IRP_MJ_MAXIMUM_FUNCTION
+ 1;
741 if (!(manager
= (struct device_manager
*)get_handle_obj( current
->process
, req
->manager
,
742 0, &device_manager_ops
)))
747 if ((irp
= (struct irp_call
*)get_handle_obj( current
->process
, req
->prev
, 0, &irp_call_ops
)))
749 set_irp_result( irp
, req
->status
, NULL
, 0, 0 );
750 close_handle( current
->process
, req
->prev
); /* avoid an extra round-trip for close */
751 release_object( irp
);
756 if ((ptr
= list_head( &manager
->requests
)))
758 irp
= LIST_ENTRY( ptr
, struct irp_call
, mgr_entry
);
761 reply
->client_pid
= get_process_id( irp
->thread
->process
);
762 reply
->client_tid
= get_thread_id( irp
->thread
);
764 reply
->params
= irp
->params
;
766 reply
->in_size
= iosb
->in_size
;
767 reply
->out_size
= iosb
->out_size
;
768 if (iosb
->in_size
> get_reply_max_size()) set_error( STATUS_BUFFER_OVERFLOW
);
769 else if ((reply
->next
= alloc_handle( current
->process
, irp
, 0, 0 )))
771 set_reply_data_ptr( iosb
->in_data
, iosb
->in_size
);
772 iosb
->in_data
= NULL
;
774 list_remove( &irp
->mgr_entry
);
775 list_init( &irp
->mgr_entry
);
778 else set_error( STATUS_PENDING
);
780 release_object( manager
);
784 /* store results of an async irp */
785 DECL_HANDLER(set_irp_result
)
787 struct irp_call
*irp
;
789 if ((irp
= (struct irp_call
*)get_handle_obj( current
->process
, req
->handle
, 0, &irp_call_ops
)))
791 if (irp
->file
) set_file_user_ptr( irp
->file
, req
->file_ptr
);
792 set_irp_result( irp
, req
->status
, get_req_data(), get_req_data_size(), req
->size
);
793 close_handle( current
->process
, req
->handle
); /* avoid an extra round-trip for close */
794 release_object( irp
);