1 /* SPDX-License-Identifier: GPL-2.0+ */
14 #include "alloc-util.h"
15 #include "device-private.h"
16 #include "device-util.h"
18 #include "format-util.h"
19 #include "libudev-util.h"
20 #include "netlink-util.h"
21 #include "path-util.h"
22 #include "process-util.h"
23 #include "rlimit-util.h"
24 #include "signal-util.h"
25 #include "stdio-util.h"
26 #include "string-util.h"
29 #include "udev-builtin.h"
30 #include "udev-node.h"
31 #include "udev-watch.h"
34 typedef struct Spawn
{
37 usec_t timeout_warn_usec
;
39 usec_t event_birth_usec
;
48 UdevEvent
*udev_event_new(sd_device
*dev
, usec_t exec_delay_usec
, sd_netlink
*rtnl
) {
53 event
= new(UdevEvent
, 1);
57 *event
= (UdevEvent
) {
58 .dev
= sd_device_ref(dev
),
59 .birth_usec
= now(CLOCK_MONOTONIC
),
60 .exec_delay_usec
= exec_delay_usec
,
61 .rtnl
= sd_netlink_ref(rtnl
),
67 UdevEvent
*udev_event_free(UdevEvent
*event
) {
71 sd_device_unref(event
->dev
);
72 sd_device_unref(event
->dev_db_clone
);
73 sd_netlink_unref(event
->rtnl
);
74 hashmap_free_free_key(event
->run_list
);
75 hashmap_free_free_free(event
->seclabel_list
);
76 free(event
->program_result
);
101 struct subst_map_entry
{
104 enum subst_type type
;
107 static const struct subst_map_entry map
[] = {
108 { .name
= "devnode", .fmt
= 'N', .type
= SUBST_DEVNODE
},
109 { .name
= "tempnode", .fmt
= 'N', .type
= SUBST_DEVNODE
},
110 { .name
= "attr", .fmt
= 's', .type
= SUBST_ATTR
},
111 { .name
= "sysfs", .fmt
= 's', .type
= SUBST_ATTR
},
112 { .name
= "env", .fmt
= 'E', .type
= SUBST_ENV
},
113 { .name
= "kernel", .fmt
= 'k', .type
= SUBST_KERNEL
},
114 { .name
= "number", .fmt
= 'n', .type
= SUBST_KERNEL_NUMBER
},
115 { .name
= "driver", .fmt
= 'd', .type
= SUBST_DRIVER
},
116 { .name
= "devpath", .fmt
= 'p', .type
= SUBST_DEVPATH
},
117 { .name
= "id", .fmt
= 'b', .type
= SUBST_ID
},
118 { .name
= "major", .fmt
= 'M', .type
= SUBST_MAJOR
},
119 { .name
= "minor", .fmt
= 'm', .type
= SUBST_MINOR
},
120 { .name
= "result", .fmt
= 'c', .type
= SUBST_RESULT
},
121 { .name
= "parent", .fmt
= 'P', .type
= SUBST_PARENT
},
122 { .name
= "name", .fmt
= 'D', .type
= SUBST_NAME
},
123 { .name
= "links", .fmt
= 'L', .type
= SUBST_LINKS
},
124 { .name
= "root", .fmt
= 'r', .type
= SUBST_ROOT
},
125 { .name
= "sys", .fmt
= 'S', .type
= SUBST_SYS
},
128 static ssize_t
subst_format_var(UdevEvent
*event
,
129 const struct subst_map_entry
*entry
, char *attr
,
130 char *dest
, size_t l
) {
131 sd_device
*parent
, *dev
= event
->dev
;
132 const char *val
= NULL
;
139 switch (entry
->type
) {
141 r
= sd_device_get_devpath(dev
, &val
);
144 l
= strpcpy(&s
, l
, val
);
147 r
= sd_device_get_sysname(dev
, &val
);
150 l
= strpcpy(&s
, l
, val
);
152 case SUBST_KERNEL_NUMBER
:
153 r
= sd_device_get_sysnum(dev
, &val
);
155 return r
== -ENOENT
? 0 : r
;
156 l
= strpcpy(&s
, l
, val
);
159 if (!event
->dev_parent
)
161 r
= sd_device_get_sysname(event
->dev_parent
, &val
);
164 l
= strpcpy(&s
, l
, val
);
167 if (!event
->dev_parent
)
169 r
= sd_device_get_driver(event
->dev_parent
, &val
);
171 return r
== -ENOENT
? 0 : r
;
172 l
= strpcpy(&s
, l
, val
);
176 char buf
[DECIMAL_STR_MAX(unsigned)];
178 r
= sd_device_get_devnum(dev
, &devnum
);
179 if (r
< 0 && r
!= -ENOENT
)
181 xsprintf(buf
, "%u", r
< 0 ? 0 : entry
->type
== SUBST_MAJOR
? major(devnum
) : minor(devnum
));
182 l
= strpcpy(&s
, l
, buf
);
189 if (!event
->program_result
)
192 /* get part of the result string */
195 i
= strtoul(attr
, &rest
, 10);
197 char result
[UTIL_PATH_SIZE
], tmp
[UTIL_PATH_SIZE
], *cpos
;
199 strscpy(result
, sizeof(result
), event
->program_result
);
202 while (cpos
[0] != '\0' && !isspace(cpos
[0]))
204 while (isspace(cpos
[0]))
210 log_error("requested part of result string not found");
213 strscpy(tmp
, sizeof(tmp
), cpos
);
214 /* %{2+}c copies the whole string from the second part on */
215 if (rest
[0] != '+') {
216 cpos
= strchr(tmp
, ' ');
220 l
= strpcpy(&s
, l
, tmp
);
222 l
= strpcpy(&s
, l
, event
->program_result
);
226 char vbuf
[UTIL_NAME_SIZE
];
233 /* try to read the value specified by "[dmi/id]product_name" */
234 if (util_resolve_subsys_kernel(attr
, vbuf
, sizeof(vbuf
), true) == 0)
237 /* try to read the attribute the device */
239 (void) sd_device_get_sysattr_value(dev
, attr
, &val
);
241 /* try to read the attribute of the parent device, other matches have selected */
242 if (!val
&& event
->dev_parent
&& event
->dev_parent
!= dev
)
243 (void) sd_device_get_sysattr_value(event
->dev_parent
, attr
, &val
);
248 /* strip trailing whitespace, and replace unwanted characters */
250 strscpy(vbuf
, sizeof(vbuf
), val
);
252 while (len
> 0 && isspace(vbuf
[--len
]))
254 count
= util_replace_chars(vbuf
, UDEV_ALLOWED_CHARS_INPUT
);
256 log_device_debug(dev
, "%i character(s) replaced", count
);
257 l
= strpcpy(&s
, l
, vbuf
);
261 r
= sd_device_get_parent(dev
, &parent
);
263 return r
== -ENODEV
? 0 : r
;
264 r
= sd_device_get_devname(parent
, &val
);
266 return r
== -ENOENT
? 0 : r
;
267 l
= strpcpy(&s
, l
, val
+ STRLEN("/dev/"));
270 r
= sd_device_get_devname(dev
, &val
);
272 return r
== -ENOENT
? 0 : r
;
273 l
= strpcpy(&s
, l
, val
);
277 l
= strpcpy(&s
, l
, event
->name
);
278 else if (sd_device_get_devname(dev
, &val
) >= 0)
279 l
= strpcpy(&s
, l
, val
+ STRLEN("/dev/"));
281 r
= sd_device_get_sysname(dev
, &val
);
284 l
= strpcpy(&s
, l
, val
);
288 FOREACH_DEVICE_DEVLINK(dev
, val
)
290 l
= strpcpy(&s
, l
, val
+ STRLEN("/dev/"));
292 l
= strpcpyl(&s
, l
, " ", val
+ STRLEN("/dev/"), NULL
);
295 l
= strpcpy(&s
, l
, "/dev");
298 l
= strpcpy(&s
, l
, "/sys");
303 r
= sd_device_get_property_value(dev
, attr
, &val
);
305 return r
== -ENOENT
? 0 : r
;
306 l
= strpcpy(&s
, l
, val
);
309 assert_not_reached("Unknown format substitution type");
315 ssize_t
udev_event_apply_format(UdevEvent
*event
,
316 const char *src
, char *dest
, size_t size
,
317 bool replace_whitespace
) {
333 const struct subst_map_entry
*entry
= NULL
;
334 char attrbuf
[UTIL_PATH_SIZE
], *attr
;
335 bool format_dollar
= false;
338 while (from
[0] != '\0') {
339 if (from
[0] == '$') {
340 /* substitute named variable */
343 if (from
[1] == '$') {
348 for (i
= 0; i
< ELEMENTSOF(map
); i
++) {
349 if (startswith(&from
[1], map
[i
].name
)) {
351 from
+= strlen(map
[i
].name
)+1;
352 format_dollar
= true;
356 } else if (from
[0] == '%') {
357 /* substitute format char */
360 if (from
[1] == '%') {
365 for (i
= 0; i
< ELEMENTSOF(map
); i
++) {
366 if (from
[1] == map
[i
].fmt
) {
375 if (l
< 2) /* need space for this char and the terminating NUL */
385 /* extract possible $format{attr} */
386 if (from
[0] == '{') {
390 for (i
= 0; from
[i
] != '}'; i
++)
391 if (from
[i
] == '\0') {
392 log_error("missing closing brace for format '%s'", src
);
396 if (i
>= sizeof(attrbuf
))
398 memcpy(attrbuf
, from
, i
);
405 subst_len
= subst_format_var(event
, entry
, attr
, s
, l
);
408 log_device_warning_errno(event
->dev
, subst_len
, "Failed to substitute variable '$%s', ignoring: %m", entry
->name
);
410 log_device_warning_errno(event
->dev
, subst_len
, "Failed to apply format '%%%c', ignoring: %m", entry
->fmt
);
415 /* SUBST_RESULT handles spaces itself */
416 if (replace_whitespace
&& entry
->type
!= SUBST_RESULT
)
417 /* util_replace_whitespace can replace in-place,
418 * and does nothing if subst_len == 0
420 subst_len
= util_replace_whitespace(s
, s
, subst_len
);
432 static int on_spawn_io(sd_event_source
*s
, int fd
, uint32_t revents
, void *userdata
) {
433 Spawn
*spawn
= userdata
;
439 assert(fd
== spawn
->fd_stdout
|| fd
== spawn
->fd_stderr
);
440 assert(!spawn
->result
|| spawn
->result_len
< spawn
->result_size
);
442 if (fd
== spawn
->fd_stdout
&& spawn
->result
) {
443 p
= spawn
->result
+ spawn
->result_len
;
444 size
= spawn
->result_size
- spawn
->result_len
;
450 l
= read(fd
, p
, size
- 1);
453 log_error_errno(errno
, "Failed to read stdout of '%s': %m", spawn
->cmd
);
459 if (fd
== spawn
->fd_stdout
&& spawn
->result
)
460 spawn
->result_len
+= l
;
462 /* Log output only if we watch stderr. */
463 if (l
> 0 && spawn
->fd_stderr
>= 0) {
464 _cleanup_strv_free_
char **v
= NULL
;
467 v
= strv_split_newlines(p
);
472 log_debug("'%s'(%s) '%s'", spawn
->cmd
,
473 fd
== spawn
->fd_stdout
? "out" : "err", *q
);
479 static int on_spawn_timeout(sd_event_source
*s
, uint64_t usec
, void *userdata
) {
480 Spawn
*spawn
= userdata
;
481 char timeout
[FORMAT_TIMESPAN_MAX
];
485 kill_and_sigcont(spawn
->pid
, SIGKILL
);
487 log_error("Spawned process '%s' ["PID_FMT
"] timed out after %s, killing", spawn
->cmd
, spawn
->pid
,
488 format_timespan(timeout
, sizeof(timeout
), spawn
->timeout_usec
, USEC_PER_SEC
));
493 static int on_spawn_timeout_warning(sd_event_source
*s
, uint64_t usec
, void *userdata
) {
494 Spawn
*spawn
= userdata
;
495 char timeout
[FORMAT_TIMESPAN_MAX
];
499 log_warning("Spawned process '%s' ["PID_FMT
"] is taking longer than %s to complete", spawn
->cmd
, spawn
->pid
,
500 format_timespan(timeout
, sizeof(timeout
), spawn
->timeout_warn_usec
, USEC_PER_SEC
));
505 static int on_spawn_sigchld(sd_event_source
*s
, const siginfo_t
*si
, void *userdata
) {
506 Spawn
*spawn
= userdata
;
510 switch (si
->si_code
) {
512 if (si
->si_status
== 0) {
513 log_debug("Process '%s' succeeded.", spawn
->cmd
);
514 sd_event_exit(sd_event_source_get_event(s
), 0);
519 log_full(spawn
->accept_failure
? LOG_DEBUG
: LOG_WARNING
,
520 "Process '%s' failed with exit code %i.", spawn
->cmd
, si
->si_status
);
524 log_warning("Process '%s' terminated by signal %s.", spawn
->cmd
, signal_to_string(si
->si_status
));
528 log_error("Process '%s' failed due to unknown reason.", spawn
->cmd
);
531 sd_event_exit(sd_event_source_get_event(s
), -EIO
);
536 static int spawn_wait(Spawn
*spawn
) {
537 _cleanup_(sd_event_unrefp
) sd_event
*e
= NULL
;
542 r
= sd_event_new(&e
);
546 if (spawn
->timeout_usec
> 0) {
547 usec_t usec
, age_usec
;
549 usec
= now(CLOCK_MONOTONIC
);
550 age_usec
= usec
- spawn
->event_birth_usec
;
551 if (age_usec
< spawn
->timeout_usec
) {
552 if (spawn
->timeout_warn_usec
> 0 &&
553 spawn
->timeout_warn_usec
< spawn
->timeout_usec
&&
554 spawn
->timeout_warn_usec
> age_usec
) {
555 spawn
->timeout_warn_usec
-= age_usec
;
557 r
= sd_event_add_time(e
, NULL
, CLOCK_MONOTONIC
,
558 usec
+ spawn
->timeout_warn_usec
, USEC_PER_SEC
,
559 on_spawn_timeout_warning
, spawn
);
564 spawn
->timeout_usec
-= age_usec
;
566 r
= sd_event_add_time(e
, NULL
, CLOCK_MONOTONIC
,
567 usec
+ spawn
->timeout_usec
, USEC_PER_SEC
, on_spawn_timeout
, spawn
);
573 r
= sd_event_add_io(e
, NULL
, spawn
->fd_stdout
, EPOLLIN
, on_spawn_io
, spawn
);
577 r
= sd_event_add_io(e
, NULL
, spawn
->fd_stderr
, EPOLLIN
, on_spawn_io
, spawn
);
581 r
= sd_event_add_child(e
, NULL
, spawn
->pid
, WEXITED
, on_spawn_sigchld
, spawn
);
585 r
= sd_event_loop(e
);
589 r
= sd_event_get_exit_code(e
, &ret
);
596 int udev_event_spawn(UdevEvent
*event
,
600 char *result
, size_t ressize
) {
601 _cleanup_close_pair_
int outpipe
[2] = {-1, -1}, errpipe
[2] = {-1, -1};
602 _cleanup_strv_free_
char **argv
= NULL
;
610 assert(result
|| ressize
== 0);
612 /* pipes from child to parent */
613 if (result
|| log_get_max_level() >= LOG_INFO
)
614 if (pipe2(outpipe
, O_NONBLOCK
|O_CLOEXEC
) != 0)
615 return log_error_errno(errno
, "Failed to create pipe for command '%s': %m", cmd
);
617 if (log_get_max_level() >= LOG_INFO
)
618 if (pipe2(errpipe
, O_NONBLOCK
|O_CLOEXEC
) != 0)
619 return log_error_errno(errno
, "Failed to create pipe for command '%s': %m", cmd
);
621 argv
= strv_split_full(cmd
, NULL
, SPLIT_QUOTES
|SPLIT_RELAX
);
625 if (isempty(argv
[0]))
626 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
627 "Invalid command '%s'", cmd
);
629 /* allow programs in /usr/lib/udev/ to be called without the path */
630 if (!path_is_absolute(argv
[0])) {
633 program
= path_join(UDEVLIBEXECDIR
, argv
[0]);
637 free_and_replace(argv
[0], program
);
640 r
= device_get_properties_strv(event
->dev
, &envp
);
642 return log_device_error_errno(event
->dev
, r
, "Failed to get device properties");
644 log_debug("Starting '%s'", cmd
);
646 r
= safe_fork("(spawn)", FORK_RESET_SIGNALS
|FORK_DEATHSIG
|FORK_LOG
, &pid
);
648 return log_error_errno(r
, "Failed to fork() to execute command '%s': %m", cmd
);
650 if (rearrange_stdio(-1, outpipe
[WRITE_END
], errpipe
[WRITE_END
]) < 0)
653 (void) close_all_fds(NULL
, 0);
654 (void) rlimit_nofile_safe();
656 execve(argv
[0], argv
, envp
);
660 /* parent closed child's ends of pipes */
661 outpipe
[WRITE_END
] = safe_close(outpipe
[WRITE_END
]);
662 errpipe
[WRITE_END
] = safe_close(errpipe
[WRITE_END
]);
667 .accept_failure
= accept_failure
,
668 .timeout_warn_usec
= udev_warn_timeout(timeout_usec
),
669 .timeout_usec
= timeout_usec
,
670 .event_birth_usec
= event
->birth_usec
,
671 .fd_stdout
= outpipe
[READ_END
],
672 .fd_stderr
= errpipe
[READ_END
],
674 .result_size
= ressize
,
676 r
= spawn_wait(&spawn
);
678 return log_error_errno(r
, "Failed to wait spawned command '%s': %m", cmd
);
681 result
[spawn
.result_len
] = '\0';
686 static int rename_netif(UdevEvent
*event
) {
687 sd_device
*dev
= event
->dev
;
688 const char *action
, *oldname
;
693 return 0; /* No new name is requested. */
695 r
= sd_device_get_sysname(dev
, &oldname
);
697 return log_device_error_errno(dev
, r
, "Failed to get sysname: %m");
699 if (streq(event
->name
, oldname
))
700 return 0; /* The interface name is already requested name. */
702 r
= sd_device_get_property_value(dev
, "ACTION", &action
);
704 return log_device_error_errno(dev
, r
, "Failed to get property 'ACTION': %m");
706 if (!streq(action
, "add"))
707 return 0; /* Rename the interface only when it is added. */
709 r
= sd_device_get_ifindex(dev
, &ifindex
);
711 return 0; /* Device is not a network interface. */
713 return log_device_error_errno(dev
, r
, "Failed to get ifindex: %m");
715 strscpy(name
, IFNAMSIZ
, event
->name
);
716 r
= rtnl_set_link_name(&event
->rtnl
, ifindex
, name
);
718 return log_device_error_errno(dev
, r
, "Failed to rename network interface %i from '%s' to '%s': %m", ifindex
, oldname
, name
);
720 r
= device_rename(dev
, event
->name
);
722 return log_warning_errno(r
, "Network interface %i is renamed from '%s' to '%s', but could not update sd_device object: %m", ifindex
, oldname
, name
);
724 log_device_debug(dev
, "Network interface %i is renamed from '%s' to '%s'", ifindex
, oldname
, name
);
729 static int update_devnode(UdevEvent
*event
) {
730 sd_device
*dev
= event
->dev
;
735 r
= sd_device_get_devnum(dev
, NULL
);
739 return log_device_error_errno(dev
, r
, "Failed to get devnum: %m");
741 /* remove/update possible left-over symlinks from old database entry */
742 if (event
->dev_db_clone
)
743 (void) udev_node_update_old_links(dev
, event
->dev_db_clone
);
745 if (!event
->owner_set
) {
746 r
= device_get_devnode_uid(dev
, &event
->uid
);
747 if (r
< 0 && r
!= -ENOENT
)
748 return log_device_error_errno(dev
, r
, "Failed to get devnode UID: %m");
751 if (!event
->group_set
) {
752 r
= device_get_devnode_gid(dev
, &event
->gid
);
753 if (r
< 0 && r
!= -ENOENT
)
754 return log_device_error_errno(dev
, r
, "Failed to get devnode GID: %m");
757 if (!event
->mode_set
) {
758 r
= device_get_devnode_mode(dev
, &event
->mode
);
759 if (r
< 0 && r
!= -ENOENT
)
760 return log_device_error_errno(dev
, r
, "Failed to get devnode mode: %m");
763 /* default 0660 if a group is assigned */
771 r
= sd_device_get_property_value(dev
, "ACTION", &action
);
773 return log_device_error_errno(dev
, r
, "Failed to get property 'ACTION': %m");
775 apply
= streq(action
, "add") || event
->owner_set
|| event
->group_set
|| event
->mode_set
;
776 return udev_node_add(dev
, apply
, event
->mode
, event
->uid
, event
->gid
, event
->seclabel_list
);
779 static void event_execute_rules_on_remove(
782 Hashmap
*properties_list
,
785 sd_device
*dev
= event
->dev
;
788 r
= device_read_db_internal(dev
, true);
790 log_device_debug_errno(dev
, r
, "Failed to read database under /run/udev/data/: %m");
792 r
= device_tag_index(dev
, NULL
, false);
794 log_device_debug_errno(dev
, r
, "Failed to remove corresponding tag files under /run/udev/tag/, ignoring: %m");
796 r
= device_delete_db(dev
);
798 log_device_debug_errno(dev
, r
, "Failed to delete database under /run/udev/data/, ignoring: %m");
800 if (sd_device_get_devnum(dev
, NULL
) >= 0)
801 (void) udev_watch_end(dev
);
803 (void) udev_rules_apply_to_event(rules
, event
, timeout_usec
, properties_list
);
805 if (sd_device_get_devnum(dev
, NULL
) >= 0)
806 (void) udev_node_remove(dev
);
809 int udev_event_execute_rules(UdevEvent
*event
,
811 Hashmap
*properties_list
,
813 sd_device
*dev
= event
->dev
;
814 const char *subsystem
, *action
;
820 r
= sd_device_get_subsystem(dev
, &subsystem
);
822 return log_device_error_errno(dev
, r
, "Failed to get subsystem: %m");
824 r
= sd_device_get_property_value(dev
, "ACTION", &action
);
826 return log_device_error_errno(dev
, r
, "Failed to get property 'ACTION': %m");
828 if (streq(action
, "remove")) {
829 event_execute_rules_on_remove(event
, timeout_usec
, properties_list
, rules
);
833 r
= device_clone_with_db(dev
, &event
->dev_db_clone
);
835 log_device_debug_errno(dev
, r
, "Failed to clone sd_device object, ignoring: %m");
837 if (event
->dev_db_clone
) {
838 r
= sd_device_get_devnum(dev
, NULL
);
841 log_device_debug_errno(dev
, r
, "Failed to get devnum, ignoring: %m");
843 if (streq(action
, "move")) {
844 r
= device_copy_properties(dev
, event
->dev_db_clone
);
846 log_device_debug_errno(dev
, r
, "Failed to copy properties from cloned device, ignoring: %m");
849 /* Disable watch during event processing. */
850 (void) udev_watch_end(event
->dev_db_clone
);
853 (void) udev_rules_apply_to_event(rules
, event
, timeout_usec
, properties_list
);
855 (void) rename_netif(event
);
856 (void) update_devnode(event
);
858 /* preserve old, or get new initialization timestamp */
859 r
= device_ensure_usec_initialized(dev
, event
->dev_db_clone
);
861 log_device_debug_errno(dev
, r
, "Failed to set initialization timestamp, ignoring: %m");
863 /* (re)write database file */
864 r
= device_tag_index(dev
, event
->dev_db_clone
, true);
866 log_device_debug_errno(dev
, r
, "Failed to update tags under /run/udev/tag/, ignoring: %m");
868 r
= device_update_db(dev
);
870 log_device_debug_errno(dev
, r
, "Failed to update database under /run/udev/data/, ignoring: %m");
872 device_set_is_initialized(dev
);
874 event
->dev_db_clone
= sd_device_unref(event
->dev_db_clone
);
879 void udev_event_execute_run(UdevEvent
*event
, usec_t timeout_usec
) {
884 HASHMAP_FOREACH_KEY(val
, cmd
, event
->run_list
, i
) {
885 enum udev_builtin_cmd builtin_cmd
= PTR_TO_INT(val
);
886 char command
[UTIL_PATH_SIZE
];
888 udev_event_apply_format(event
, cmd
, command
, sizeof(command
), false);
890 if (builtin_cmd
>= 0 && builtin_cmd
< _UDEV_BUILTIN_MAX
)
891 udev_builtin_run(event
->dev
, builtin_cmd
, command
, false);
893 if (event
->exec_delay_usec
> 0) {
894 log_debug("delay execution of '%s'", command
);
895 (void) usleep(event
->exec_delay_usec
);
898 udev_event_spawn(event
, timeout_usec
, false, command
, NULL
, 0);