svn commit: r336188 - head/usr.sbin/bhyve

Marcelo Araujo araujobsdport at gmail.com
Wed Jul 11 03:37:26 UTC 2018


Hi Ravi,

Yes, you are correct! I have discussed about it in the review and the
approach you mentioned is exactly I'm gonna do. Although with this patch
the intention for now is make exit(1) more unique for "powered off".

Snipped from the review:
"OK, I will update the manpage and commit it as-is just to make the exit(1)
more unique for now. I have intention to revisit it and improve all the
exit returns. I will replace fprintf/perror + exit as soon as I finish the
drivers analysis to make sure what can be improved as error, exit and
return code."

The full discussion is at that review.

Best,

2018-07-11 11:28 GMT+08:00 Ravi Pokala <rpokala at freebsd.org>:

> Hi Marcelo,
>
> If the intention is to have specific exit codes have specific meanings,
> wouldn't it be useful to set up defines or an enum or something, so a
> symbolic value can be used rather than a bare integer?
>
> Thanks,
>
> Ravi (rpokala@)
>
> -----Original Message-----
> From: <owner-src-committers at freebsd.org> on behalf of Marcelo Araujo
> <araujo at FreeBSD.org>
> Date: 2018-07-10, Tuesday at 20:23
> To: <src-committers at freebsd.org>, <svn-src-all at freebsd.org>, <
> svn-src-head at freebsd.org>
> Subject: svn commit: r336188 - head/usr.sbin/bhyve
>
> Author: araujo
> Date: Wed Jul 11 03:23:09 2018
> New Revision: 336188
> URL: https://svnweb.freebsd.org/changeset/base/336188
>
> Log:
>   Improve bhyve exit(3) error code.
>
>   The bhyve(8) exit status indicates how the VM was terminated:
>
>   0     rebooted
>   1     powered off
>   2     halted
>   3     triple fault
>
>   The problem is when we have wrappers around bhyve that parses the exit
>   error code and gets an exit(1) for an error but interprets it as
> "powered off".
>   So to mitigate this issue and makes it less error prone for third part
>   applications, I have added a new exit code 4 that is "exited due to an
> error".
>
>   For now the bhyve(8) exit status are:
>   0     rebooted
>   1     powered off
>   2     halted
>   3     triple fault
>   4     exited due to an error
>
>   Reviewed by:  @jhb
>   MFC after:    2 weeks.
>   Sponsored by: iXsystems Inc.
>   Differential Revision:        https://reviews.freebsd.org/D16161
>
> Modified:
>   head/usr.sbin/bhyve/bhyve.8
>   head/usr.sbin/bhyve/bhyverun.c
>   head/usr.sbin/bhyve/dbgport.c
>   head/usr.sbin/bhyve/fwctl.c
>   head/usr.sbin/bhyve/mevent_test.c
>   head/usr.sbin/bhyve/pci_e82545.c
>
> Modified: head/usr.sbin/bhyve/bhyve.8
> ============================================================
> ==================
> --- head/usr.sbin/bhyve/bhyve.8 Wed Jul 11 02:32:06 2018        (r336187)
> +++ head/usr.sbin/bhyve/bhyve.8 Wed Jul 11 03:23:09 2018        (r336188)
> @@ -24,7 +24,7 @@
>  .\"
>  .\" $FreeBSD$
>  .\"
> -.Dd Jul 05, 2018
> +.Dd Jul 11, 2018
>  .Dt BHYVE 8
>  .Os
>  .Sh NAME
> @@ -520,6 +520,8 @@ powered off
>  halted
>  .It 3
>  triple fault
> +.It 4
> +exited due to an error
>  .El
>  .Sh EXAMPLES
>  If not using a boot ROM, the guest operating system must have been loaded
> with
>
> Modified: head/usr.sbin/bhyve/bhyverun.c
> ============================================================
> ==================
> --- head/usr.sbin/bhyve/bhyverun.c      Wed Jul 11 02:32:06 2018
> (r336187)
> +++ head/usr.sbin/bhyve/bhyverun.c      Wed Jul 11 03:23:09 2018
> (r336188)
> @@ -397,7 +397,7 @@ fbsdrun_deletecpu(struct vmctx *ctx, int vcpu)
>
>         if (!CPU_ISSET(vcpu, &cpumask)) {
>                 fprintf(stderr, "Attempting to delete unknown cpu %d\n",
> vcpu);
> -               exit(1);
> +               exit(4);
>         }
>
>         CPU_CLR_ATOMIC(vcpu, &cpumask);
> @@ -742,7 +742,7 @@ vm_loop(struct vmctx *ctx, int vcpu, uint64_t startrip
>                 if (exitcode >= VM_EXITCODE_MAX || handler[exitcode] ==
> NULL) {
>                         fprintf(stderr, "vm_loop: unexpected exitcode
> 0x%x\n",
>                             exitcode);
> -                       exit(1);
> +                       exit(4);
>                 }
>
>                 rc = (*handler[exitcode])(ctx, &vmexit[vcpu], &vcpu);
> @@ -753,7 +753,7 @@ vm_loop(struct vmctx *ctx, int vcpu, uint64_t startrip
>                 case VMEXIT_ABORT:
>                         abort();
>                 default:
> -                       exit(1);
> +                       exit(4);
>                 }
>         }
>         fprintf(stderr, "vm_run error %d, errno %d\n", error, errno);
> @@ -785,7 +785,7 @@ fbsdrun_set_capabilities(struct vmctx *ctx, int cpu)
>                 err = vm_get_capability(ctx, cpu, VM_CAP_HALT_EXIT, &tmp);
>                 if (err < 0) {
>                         fprintf(stderr, "VM exit on HLT not supported\n");
> -                       exit(1);
> +                       exit(4);
>                 }
>                 vm_set_capability(ctx, cpu, VM_CAP_HALT_EXIT, 1);
>                 if (cpu == BSP)
> @@ -800,7 +800,7 @@ fbsdrun_set_capabilities(struct vmctx *ctx, int cpu)
>                 if (err < 0) {
>                         fprintf(stderr,
>                             "SMP mux requested, no pause support\n");
> -                       exit(1);
> +                       exit(4);
>                 }
>                 vm_set_capability(ctx, cpu, VM_CAP_PAUSE_EXIT, 1);
>                 if (cpu == BSP)
> @@ -814,7 +814,7 @@ fbsdrun_set_capabilities(struct vmctx *ctx, int cpu)
>
>         if (err) {
>                 fprintf(stderr, "Unable to set x2apic state (%d)\n", err);
> -               exit(1);
> +               exit(4);
>         }
>
>         vm_set_capability(ctx, cpu, VM_CAP_ENABLE_INVPCID, 1);
> @@ -850,7 +850,7 @@ do_open(const char *vmname)
>                         }
>                 } else {
>                         perror("vm_create");
> -                       exit(1);
> +                       exit(4);
>                 }
>         } else {
>                 if (!romboot) {
> @@ -859,14 +859,14 @@ do_open(const char *vmname)
>                          * bootrom must be configured to boot it.
>                          */
>                         fprintf(stderr, "virtual machine cannot be
> booted\n");
> -                       exit(1);
> +                       exit(4);
>                 }
>         }
>
>         ctx = vm_open(vmname);
>         if (ctx == NULL) {
>                 perror("vm_open");
> -               exit(1);
> +               exit(4);
>         }
>
>  #ifndef WITHOUT_CAPSICUM
> @@ -888,7 +888,7 @@ do_open(const char *vmname)
>                 error = vm_reinit(ctx);
>                 if (error) {
>                         perror("vm_reinit");
> -                       exit(1);
> +                       exit(4);
>                 }
>         }
>         error = vm_set_topology(ctx, sockets, cores, threads, maxcpus);
> @@ -967,7 +967,7 @@ main(int argc, char *argv[])
>                         break;
>                 case 's':
>                         if (pci_parse_slot(optarg) != 0)
> -                               exit(1);
> +                               exit(4);
>                         else
>                                 break;
>                 case 'S':
> @@ -1033,7 +1033,7 @@ main(int argc, char *argv[])
>         if (guest_ncpus > max_vcpus) {
>                 fprintf(stderr, "%d vCPUs requested but only %d
> available\n",
>                         guest_ncpus, max_vcpus);
> -               exit(1);
> +               exit(4);
>         }
>
>         fbsdrun_set_capabilities(ctx, BSP);
> @@ -1042,13 +1042,13 @@ main(int argc, char *argv[])
>         err = vm_setup_memory(ctx, memsize, VM_MMAP_ALL);
>         if (err) {
>                 fprintf(stderr, "Unable to setup memory (%d)\n", errno);
> -               exit(1);
> +               exit(4);
>         }
>
>         error = init_msr();
>         if (error) {
>                 fprintf(stderr, "init_msr error %d", error);
> -               exit(1);
> +               exit(4);
>         }
>
>         init_mem();
> @@ -1063,8 +1063,10 @@ main(int argc, char *argv[])
>         /*
>          * Exit if a device emulation finds an error in its initilization
>          */
> -       if (init_pci(ctx) != 0)
> -               exit(1);
> +       if (init_pci(ctx) != 0) {
> +               perror("device emulation initialization error");
> +               exit(4);
> +       }
>
>         if (dbg_port != 0)
>                 init_dbgport(dbg_port);
> @@ -1079,7 +1081,7 @@ main(int argc, char *argv[])
>                 if (vm_set_capability(ctx, BSP, VM_CAP_UNRESTRICTED_GUEST,
> 1)) {
>                         fprintf(stderr, "ROM boot failed: unrestricted
> guest "
>                             "capability not available\n");
> -                       exit(1);
> +                       exit(4);
>                 }
>                 error = vcpu_reset(ctx, BSP);
>                 assert(error == 0);
> @@ -1093,8 +1095,10 @@ main(int argc, char *argv[])
>          */
>         if (mptgen) {
>                 error = mptable_build(ctx, guest_ncpus);
> -               if (error)
> -                       exit(1);
> +               if (error) {
> +                       perror("error to build the guest tables");
> +                       exit(4);
> +               }
>         }
>
>         error = smbios_build(ctx);
> @@ -1133,5 +1137,5 @@ main(int argc, char *argv[])
>          */
>         mevent_dispatch();
>
> -       exit(1);
> +       exit(4);
>  }
>
> Modified: head/usr.sbin/bhyve/dbgport.c
> ============================================================
> ==================
> --- head/usr.sbin/bhyve/dbgport.c       Wed Jul 11 02:32:06 2018
> (r336187)
> +++ head/usr.sbin/bhyve/dbgport.c       Wed Jul 11 03:23:09 2018
> (r336188)
> @@ -139,8 +139,8 @@ init_dbgport(int sport)
>         conn_fd = -1;
>
>         if ((listen_fd = socket(AF_INET, SOCK_STREAM, 0)) < 0) {
> -               perror("socket");
> -               exit(1);
> +               perror("cannot create socket");
> +               exit(4);
>         }
>
>         sin.sin_len = sizeof(sin);
> @@ -151,18 +151,18 @@ init_dbgport(int sport)
>         reuse = 1;
>         if (setsockopt(listen_fd, SOL_SOCKET, SO_REUSEADDR, &reuse,
>             sizeof(reuse)) < 0) {
> -               perror("setsockopt");
> -               exit(1);
> +               perror("cannot set socket options");
> +               exit(4);
>         }
>
>         if (bind(listen_fd, (struct sockaddr *)&sin, sizeof(sin)) < 0) {
> -               perror("bind");
> -               exit(1);
> +               perror("cannot bind socket");
> +               exit(4);
>         }
>
>         if (listen(listen_fd, 1) < 0) {
> -               perror("listen");
> -               exit(1);
> +               perror("cannot listen socket");
> +               exit(4);
>         }
>
>  #ifndef WITHOUT_CAPSICUM
>
> Modified: head/usr.sbin/bhyve/fwctl.c
> ============================================================
> ==================
> --- head/usr.sbin/bhyve/fwctl.c Wed Jul 11 02:32:06 2018        (r336187)
> +++ head/usr.sbin/bhyve/fwctl.c Wed Jul 11 03:23:09 2018        (r336188)
> @@ -375,7 +375,7 @@ fwctl_request(uint32_t value)
>                 /* Verify size */
>                 if (value < 12) {
>                         printf("msg size error");
> -                       exit(1);
> +                       exit(4);
>                 }
>                 rinfo.req_size = value;
>                 rinfo.req_count = 1;
>
> Modified: head/usr.sbin/bhyve/mevent_test.c
> ============================================================
> ==================
> --- head/usr.sbin/bhyve/mevent_test.c   Wed Jul 11 02:32:06 2018
> (r336187)
> +++ head/usr.sbin/bhyve/mevent_test.c   Wed Jul 11 03:23:09 2018
> (r336188)
> @@ -143,7 +143,7 @@ echoer(void *param)
>         mev = mevent_add(fd, EVF_READ, echoer_callback, &sync);
>         if (mev == NULL) {
>                 printf("Could not allocate echoer event\n");
> -               exit(1);
> +               exit(4);
>         }
>
>         while (!pthread_cond_wait(&sync.e_cond, &sync.e_mt)) {
> @@ -200,8 +200,8 @@ acceptor(void *param)
>         static int first;
>
>         if ((s = socket(AF_INET, SOCK_STREAM, 0)) < 0) {
> -               perror("socket");
> -               exit(1);
> +               perror("cannot create socket");
> +               exit(4);
>         }
>
>         sin.sin_len = sizeof(sin);
> @@ -210,13 +210,13 @@ acceptor(void *param)
>         sin.sin_port = htons(TEST_PORT);
>
>         if (bind(s, (struct sockaddr *)&sin, sizeof(sin)) < 0) {
> -               perror("bind");
> -               exit(1);
> +               perror("cannot bind socket");
> +               exit(4);
>         }
>
>         if (listen(s, 1) < 0) {
> -               perror("listen");
> -               exit(1);
> +               perror("cannot listen socket");
> +               exit(4);
>         }
>
>         (void) mevent_add(s, EVF_READ, acceptor_callback, NULL);
>
> Modified: head/usr.sbin/bhyve/pci_e82545.c
> ============================================================
> ==================
> --- head/usr.sbin/bhyve/pci_e82545.c    Wed Jul 11 02:32:06 2018
> (r336187)
> +++ head/usr.sbin/bhyve/pci_e82545.c    Wed Jul 11 03:23:09 2018
> (r336188)
> @@ -2224,7 +2224,7 @@ e82545_open_tap(struct e82545_softc *sc, char *opts)
>         sc->esc_tapfd = open(tbuf, O_RDWR);
>         if (sc->esc_tapfd == -1) {
>                 DPRINTF("unable to open tap device %s\n", opts);
> -               exit(1);
> +               exit(4);
>         }
>
>         /*
>
>
>
>


-- 

-- 
Marcelo Araujo            (__)araujo at FreeBSD.org
\\\'',)http://www.FreeBSD.org <http://www.freebsd.org/>   \/  \ ^
Power To Server.         .\. /_)


More information about the svn-src-all mailing list