lowRISC / opentitan

OpenTitan: Open source silicon root of trust
https://www.opentitan.org
Apache License 2.0
2.58k stars 777 forks source link

[doc:build_docs.py] can't build document on ubunt WSL for windows 10 #3901

Closed rasmus-madsen closed 4 years ago

rasmus-madsen commented 4 years ago

previously I have not had any issues building the document on my Linux subsystem but even after upgrading and updating I am having this issue.

rasmus@JBMPTN2:~/opnetitan$ sudo ./util/build_docs.py --preview
INFO: Parsed hw/ip/aes/data/aes.hjson
INFO: Parsed hw/top_earlgrey/ip/alert_handler/data/autogen/alert_handler.hjson
INFO: Parsed hw/ip/entropy_src/data/entropy_src.hjson
INFO: Parsed hw/ip/csrng/data/csrng.hjson
INFO: Parsed hw/ip/edn/data/edn.hjson
INFO: Parsed hw/ip/flash_ctrl/data/flash_ctrl.hjson
INFO: Parsed hw/ip/gpio/data/gpio.hjson
INFO: Parsed hw/ip/hmac/data/hmac.hjson
INFO: Parsed hw/ip/i2c/data/i2c.hjson
INFO: Parsed hw/ip/keymgr/data/keymgr.hjson
INFO: Parsed hw/ip/lc_ctrl/data/lc_ctrl.hjson
WARNING: NMI_GEN contains extra key reset_request_list
INFO: Parsed hw/ip/nmi_gen/data/nmi_gen.hjson
INFO: Parsed hw/ip/otbn/data/otbn.hjson
INFO: Parsed hw/ip/otp_ctrl/data/otp_ctrl.hjson
INFO: Parsed hw/ip/padctrl/data/padctrl.hjson
INFO: Parsed hw/ip/pattgen/data/pattgen.hjson
INFO: Parsed hw/top_earlgrey/ip/pinmux/data/autogen/pinmux.hjson
WARNING: !!MIO_OUTSEL not found in register list.
WARNING: !!MIO_OUTSEL not found in register list.
WARNING: !!MIO_OUTSEL not found in register list.
WARNING: !!MIO_OUT_SLEEP_VAL not found in register list.
WARNING: !!MIO_OUTSEL not found in register list.
WARNING: !!MIO_OUTSEL not found in register list.
WARNING: !!MIO_OUTSEL not found in register list.
WARNING: !!MIO_OUT_SLEEP_VAL not found in register list.
WARNING: !!WKUP_DETECTOR not found in register list.
WARNING: !!WKUP_DETECTOR_CNT_TH not found in register list.
WARNING: !!WKUP_DETECTOR_PADSEL not found in register list.
WARNING: !!WKUP_DETECTOR_CNT_TH not found in register list.
WARNING: !!WKUP_DETECTOR_CNT_TH not found in register list.
WARNING: !!WKUP_DETECTOR_PADSEL not found in register list.
WARNING: !!WKUP_DETECTOR_PADSEL not found in register list.
WARNING: !!WKUP_DETECTOR not found in register list.
WARNING: !!WKUP_DETECTOR not found in register list.
WARNING: !!PERIPH_INSEL not found in register list.
INFO: Parsed hw/top_earlgrey/ip/pwrmgr/data/autogen/pwrmgr.hjson
WARNING: SW_RST_CTRL_N: hwext register readable by software cannot be hro. Changing it to hrw.
WARNING: SW_RST_CTRL_N: hwext register readable by software cannot be hro. Changing it to hrw.
INFO: Parsed hw/top_earlgrey/ip/rstmgr/data/autogen/rstmgr.hjson
INFO: Parsed hw/top_earlgrey/ip/rv_plic/data/autogen/rv_plic.hjson
INFO: Parsed hw/ip/rv_timer/data/rv_timer.hjson
INFO: Parsed hw/ip/spi_device/data/spi_device.hjson
INFO: Parsed hw/ip/sram_ctrl/data/sram_ctrl.hjson
INFO: Parsed hw/ip/uart/data/uart.hjson
INFO: Parsed hw/ip/usbdev/data/usbdev.hjson
INFO: Parsed hw/ip/usbuart/data/usbuart.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/aes/data/aes.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/alert_handler/data/alert_handler.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/csrng/data/csrng.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/edn/data/edn.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/entropy_src/data/entropy_src.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/flash_ctrl/data/flash_ctrl.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/gpio/data/gpio.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/hmac/data/hmac.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/i2c/data/i2c.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/keymgr/data/keymgr.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/kmac/data/kmac.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/lc_ctrl/data/lc_ctrl.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/nmi_gen/data/nmi_gen.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/otbn/otbn.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/otp_ctrl/data/otp_ctrl.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/padctrl/data/padctrl.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/pattgen/data/pattgen.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/pinmux/data/pinmux.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/pwrmgr/data/pwrmgr.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/rstmgr/data/rstmgr.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/rv_core_ibex/data/rv_core_ibex.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/rv_dm/data/rv_dm.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/rv_plic/data/rv_plic.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/rv_timer/data/rv_timer.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/spi_device/data/spi_device.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/sram_ctrl/data/sram_ctrl.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/tlul/data/tlul.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/uart/data/uart.prj.hjson
INFO: Generated dashboard object for /home/rasmus/opnetitan/hw/ip/usbdev/data/usbdev.prj.hjson
ERROR: ['list of group', 'comma separated group of key:value enclosed in `{}` the second entry of the list is the sub group format']
ERROR: ['list of group', 'comma separated group of key:value enclosed in `{}` the second entry of the list is the sub group format']
INFO: Generating Software API Documentation (Doxygen)...
INFO: Generated Software API Documentation (Doxygen)
WARNING: Doxygen Generated Warnings (saved in /home/rasmus/opnetitan/build/docs-generated/sw/doxygen_warnings.log)
INFO: Generated DIF Listing for sw/device/lib/dif/dif_alert_handler.h
INFO: Generated DIF Listing for sw/device/lib/dif/dif_gpio.h
INFO: Generated DIF Listing for sw/device/lib/dif/dif_hmac.h
INFO: Generated DIF Listing for sw/device/lib/dif/dif_i2c.h
INFO: Generated DIF Listing for sw/device/lib/dif/dif_otbn.h
INFO: Generated DIF Listing for sw/device/lib/dif/dif_otp_ctrl.h
INFO: Generated DIF Listing for sw/device/lib/dif/dif_plic.h
INFO: Generated DIF Listing for sw/device/lib/dif/dif_pwrmgr.h
INFO: Generated DIF Listing for sw/device/lib/dif/dif_rstmgr.h
INFO: Generated DIF Listing for sw/device/lib/dif/dif_rv_timer.h
INFO: Generated DIF Listing for sw/device/lib/dif/dif_spi_device.h
INFO: Generated DIF Listing for sw/device/lib/dif/dif_uart.h
INFO: Generated DIF Listing for sw/device/lib/dif/dif_usbdev.h
ERROR: No DIF functions found for sw/device/lib/dif/dif_warn_unused_result.h
INFO: Generated DIF Listing for sw/device/lib/dif/dif_warn_unused_result.h
INFO: Hugo binary path: /home/rasmus/opnetitan/build/docs-hugo/hugo
INFO: Checking for correct Hugo version: 0.71.0
Built in 547 ms
Error: Error building site: process: readAndProcessContent: walk: Readdir: decorate: lstat /home/rasmus/opnetitan/rasmus@JBMPTN2.323: no such file or directory
Error building site

I see doxygen spits out a huge file of warnings but I didn't find anything in the file to indicate the actual problem. but I am not sure how to continue my debugging

imphil commented 4 years ago

This line is odd:

Error: Error building site: process: readAndProcessContent: walk: Readdir: decorate: lstat /home/rasmus/opnetitan/rasmus@JBMPTN2.323: no such file or directory

Where's the opnetitan typo coming from?

rasmus-madsen commented 4 years ago

That is just my git path i accidentally made a typo wheb i created the folder

Hent Outlook til Androidhttps://aka.ms/ghei36


From: Philipp Wagner notifications@github.com Sent: Monday, October 26, 2020 3:21:35 PM To: lowRISC/opentitan opentitan@noreply.github.com Cc: Rasmus Madsen Rasmus.Madsen@wdc.com; Author author@noreply.github.com Subject: Re: [lowRISC/opentitan] [doc:build_docs.py] can't build document on ubunt WSL for windows 10 (#3901)

This line is odd:

Error: Error building site: process: readAndProcessContent: walk: Readdir: decorate: lstat /home/rasmus/opnetitan/rasmus@JBMPTN2.323: no such file or directory

Where's the opnetitan typo coming from?

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHubhttps://github.com/lowRISC/opentitan/issues/3901#issuecomment-716578668, or unsubscribehttps://github.com/notifications/unsubscribe-auth/AM3LL7ZTNWQUXT34O232RS3SMWAW7ANCNFSM4S7NRDVQ.

rasmus-madsen commented 4 years ago

@imphil I was looking in the usbdev/data/usbdev.prj.hjson that it seem to complain about but I don't see any problems there.

imphil commented 4 years ago

This looks like https://github.com/gohugoio/hugo/issues/6526, which points at emacs backup files created in the opentitan directory, which then hang hugo (it's surprisingly picky about things in the opentitan tree it shouldn't care about). Can you try to read through the linked issue and see if any of the proposed workarounds do the trick for you?

I'd try to

rasmus-madsen commented 4 years ago

closing emacs worked for some odd reason.. thank you