Gitiles
Code Review Sign In
review.blissroms.org / Documentation-release / 8fd7bfbe8496c18e6ff09fdc4faac7330da89a61 / . / Bliss OS / taking-bug-reports / index.html
blob: 92627abe8de647355ce970a8c8a0aa5b54c7c1ae [file] [log] [blame]
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]1
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]2<!doctype html>
3<html lang="en" class="no-js">
4 <head>
5
6 <meta charset="utf-8">
7 <meta name="viewport" content="width=device-width,initial-scale=1">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]8
9
10
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]11 <link rel="shortcut icon" href="../../assets/images/favicon.png">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]12 <meta name="generator" content="mkdocs-1.1.2, mkdocs-material-6.0.1">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]13
14
15
16 <title>Taking bug reports - Team Bliss</title>
17
18
19
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]20 <link rel="stylesheet" href="../../assets/stylesheets/main.38780c08.min.css">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]21
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]22
23 <link rel="stylesheet" href="../../assets/stylesheets/palette.3f72e892.min.css">
24
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]25
26
27
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]28
29
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]30
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]31 <link href="https://fonts.gstatic.com" rel="preconnect" crossorigin>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]32 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700%7CRoboto+Mono&display=fallback">
33 <style>body,input{font-family:"Roboto",-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"Roboto Mono",SFMono-Regular,Consolas,Menlo,monospace}</style>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]34
35
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]36
37
38
39
40
41
42 </head>
43
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]44
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]45
46
47
48
49
50 <body dir="ltr" data-md-color-scheme="" data-md-color-primary="none" data-md-color-accent="none">
51
52
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]53 <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
54 <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]55 <label class="md-overlay" for="__drawer"></label>
56 <div data-md-component="skip">
57
58
59 <a href="#taking-bug-reports" class="md-skip">
60 Skip to content
61 </a>
62
63 </div>
64 <div data-md-component="announce">
65
66 </div>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]67
68 <header class="md-header" data-md-component="header">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]69 <nav class="md-header-nav md-grid" aria-label="Header">
70 <a href="../.." title="Team Bliss" class="md-header-nav__button md-logo" aria-label="Team Bliss">
71
72
73 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 003-3 3 3 0 00-3-3 3 3 0 00-3 3 3 3 0 003 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54z"/></svg>
74
75 </a>
76 <label class="md-header-nav__button md-icon" for="__drawer">
77 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2z"/></svg>
78 </label>
79 <div class="md-header-nav__title" data-md-component="header-title">
80
81 <div class="md-header-nav__ellipsis">
82 <span class="md-header-nav__topic md-ellipsis">
83 Team Bliss
84 </span>
85 <span class="md-header-nav__topic md-ellipsis">
86
87 Taking bug reports
88
89 </span>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]90 </div>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]91
92 </div>
93
94 <label class="md-header-nav__button md-icon" for="__search">
95 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0116 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 019.5 16 6.5 6.5 0 013 9.5 6.5 6.5 0 019.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
96 </label>
97
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]98<div class="md-search" data-md-component="search" role="dialog">
99 <label class="md-search__overlay" for="__search"></label>
100 <div class="md-search__inner" role="search">
101 <form class="md-search__form" name="search">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]102 <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" data-md-state="active">
103 <label class="md-search__icon md-icon" for="__search">
104 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0116 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 019.5 16 6.5 6.5 0 013 9.5 6.5 6.5 0 019.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
105 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
106 </label>
107 <button type="reset" class="md-search__icon md-icon" aria-label="Clear" data-md-component="search-reset" tabindex="-1">
108 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41z"/></svg>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]109 </button>
110 </form>
111 <div class="md-search__output">
112 <div class="md-search__scrollwrap" data-md-scrollfix>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]113 <div class="md-search-result" data-md-component="search-result">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]114 <div class="md-search-result__meta">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]115 Initializing search
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]116 </div>
117 <ol class="md-search-result__list"></ol>
118 </div>
119 </div>
120 </div>
121 </div>
122</div>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]123
124
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]125 </nav>
126</header>
127
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]128 <div class="md-container" data-md-component="container">
129
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]130
131
132
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]133 <main class="md-main" data-md-component="main">
134 <div class="md-main__inner md-grid">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]135
136
137 <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
138 <div class="md-sidebar__scrollwrap">
139 <div class="md-sidebar__inner">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]140 <nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
141 <label class="md-nav__title" for="__drawer">
142 <a href="../.." title="Team Bliss" class="md-nav__button md-logo" aria-label="Team Bliss">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]143
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]144
145 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 003-3 3 3 0 00-3-3 3 3 0 00-3 3 3 3 0 003 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54z"/></svg>
146
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]147 </a>
148 Team Bliss
149 </label>
150
151 <ul class="md-nav__list" data-md-scrollfix>
152
153
154
155
156
157
158 <li class="md-nav__item">
159 <a href="../.." title="Home" class="md-nav__link">
160 Home
161 </a>
162 </li>
163
164
165
166
167
168
169
170
171
172 <li class="md-nav__item md-nav__item--active md-nav__item--nested">
173
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]174 <input class="md-nav__toggle md-toggle" data-md-toggle="nav-2" type="checkbox" id="nav-2" checked>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]175
176 <label class="md-nav__link" for="nav-2">
177 Bliss OS
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]178 <span class="md-nav__icon md-icon"></span>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]179 </label>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]180 <nav class="md-nav" aria-label="Bliss OS" data-md-level="1">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]181 <label class="md-nav__title" for="nav-2">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]182 <span class="md-nav__icon md-icon"></span>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]183 Bliss OS
184 </label>
185 <ul class="md-nav__list" data-md-scrollfix>
186
187
188
189
190
191
192
193 <li class="md-nav__item">
194 <a href="../" title="Index" class="md-nav__link">
195 Index
196 </a>
197 </li>
198
199
200
201
202
203
204
205 <li class="md-nav__item">
206 <a href="../build-guide/" title="Build Guide" class="md-nav__link">
207 Build Guide
208 </a>
209 </li>
210
211
212
213
214
215
216
217 <li class="md-nav__item">
218 <a href="../extras/" title="Extras" class="md-nav__link">
219 Extras
220 </a>
221 </li>
222
223
224
225
226
227
228
229 <li class="md-nav__item">
230 <a href="../installation-guide-misc/" title="Installation Guide (Misc)" class="md-nav__link">
231 Installation Guide (Misc)
232 </a>
233 </li>
234
235
236
237
238
239
240
241 <li class="md-nav__item">
242 <a href="../installation-guide-surface-devices/" title="Installation Guide (Surface devices)" class="md-nav__link">
243 Installation Guide (Surface devices)
244 </a>
245 </li>
246
247
248
249
250
251
252
253 <li class="md-nav__item">
254 <a href="../installation-guide/" title="Installation Guide" class="md-nav__link">
255 Installation Guide
256 </a>
257 </li>
258
259
260
261
262
263
264
265
266
267 <li class="md-nav__item md-nav__item--active">
268
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]269 <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]270
271
272
273
274 <label class="md-nav__link md-nav__link--active" for="__toc">
275 Taking bug reports
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]276 <span class="md-nav__icon md-icon"></span>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]277 </label>
278
279 <a href="./" title="Taking bug reports" class="md-nav__link md-nav__link--active">
280 Taking bug reports
281 </a>
282
283
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]284<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]285
286
287
288
289
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]290 <label class="md-nav__title" for="__toc">
291 <span class="md-nav__icon md-icon"></span>
292 Table of contents
293 </label>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]294 <ul class="md-nav__list" data-md-scrollfix>
295
296 <li class="md-nav__item">
297 <a href="#what-information-is-required" class="md-nav__link">
298 What information is required?
299 </a>
300
301</li>
302
303 <li class="md-nav__item">
304 <a href="#capturing-logcat" class="md-nav__link">
305 Capturing logcat
306 </a>
307
308</li>
309
310 <li class="md-nav__item">
311 <a href="#drivers" class="md-nav__link">
312 Drivers
313 </a>
314
315</li>
316
317 <li class="md-nav__item">
318 <a href="#im-done-where-should-i-send-this-to" class="md-nav__link">
319 I'm done, where should I send this to?
320 </a>
321
322</li>
323
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]324 </ul>
325
326</nav>
327
328 </li>
329
330
331
332
333
334
335
336 <li class="md-nav__item">
337 <a href="../troubleshooting/" title="Troubleshooting" class="md-nav__link">
338 Troubleshooting
339 </a>
340 </li>
341
342
343 </ul>
344 </nav>
345 </li>
346
347
348
349
350
351
352
353 <li class="md-nav__item md-nav__item--nested">
354
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]355 <input class="md-nav__toggle md-toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]356
357 <label class="md-nav__link" for="nav-3">
358 BlissRoms
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]359 <span class="md-nav__icon md-icon"></span>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]360 </label>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]361 <nav class="md-nav" aria-label="BlissRoms" data-md-level="1">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]362 <label class="md-nav__title" for="nav-3">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]363 <span class="md-nav__icon md-icon"></span>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]364 BlissRoms
365 </label>
366 <ul class="md-nav__list" data-md-scrollfix>
367
368
369
370
371
372
373
374 <li class="md-nav__item">
375 <a href="../../BlissRoms/" title="Index" class="md-nav__link">
376 Index
377 </a>
378 </li>
379
380
381
382
383
384
385
386 <li class="md-nav__item">
387 <a href="../../BlissRoms/build-guide/" title="Build Guide" class="md-nav__link">
388 Build Guide
389 </a>
390 </li>
391
392
393
394
395
396
397
398 <li class="md-nav__item">
399 <a href="../../BlissRoms/build-tips/" title="Build Tips" class="md-nav__link">
400 Build Tips
401 </a>
402 </li>
403
404
405 </ul>
406 </nav>
407 </li>
408
409
410
411
412
413
414
415 <li class="md-nav__item md-nav__item--nested">
416
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]417 <input class="md-nav__toggle md-toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]418
419 <label class="md-nav__link" for="nav-4">
420 Common
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]421 <span class="md-nav__icon md-icon"></span>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]422 </label>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]423 <nav class="md-nav" aria-label="Common" data-md-level="1">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]424 <label class="md-nav__title" for="nav-4">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]425 <span class="md-nav__icon md-icon"></span>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]426 Common
427 </label>
428 <ul class="md-nav__list" data-md-scrollfix>
429
430
431
432
433
434
435
436 <li class="md-nav__item">
437 <a href="../../common/" title="Index" class="md-nav__link">
438 Index
439 </a>
440 </li>
441
442
443
444
445
446
447
448 <li class="md-nav__item">
449 <a href="../../common/git-started/" title="Git Started" class="md-nav__link">
450 Git Started
451 </a>
452 </li>
453
454
455
456
457
458
459
460 <li class="md-nav__item">
461 <a href="../../common/maintaining-proper-authorship/" title="Maintaining proper authorship" class="md-nav__link">
462 Maintaining proper authorship
463 </a>
464 </li>
465
466
467
468
469
470
471
472 <li class="md-nav__item">
473 <a href="../../common/using-dippy-bird/" title="Using `dippy-bird`" class="md-nav__link">
474 Using `dippy-bird`
475 </a>
476 </li>
477
478
479 </ul>
480 </nav>
481 </li>
482
483
484
485
486
487
488
489 <li class="md-nav__item md-nav__item--nested">
490
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]491 <input class="md-nav__toggle md-toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]492
493 <label class="md-nav__link" for="nav-5">
494 Infrastructure
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]495 <span class="md-nav__icon md-icon"></span>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]496 </label>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]497 <nav class="md-nav" aria-label="Infrastructure" data-md-level="1">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]498 <label class="md-nav__title" for="nav-5">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]499 <span class="md-nav__icon md-icon"></span>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]500 Infrastructure
501 </label>
502 <ul class="md-nav__list" data-md-scrollfix>
503
504
505
506
507
508
509
510 <li class="md-nav__item">
511 <a href="../../infrastructure/" title="Index" class="md-nav__link">
512 Index
513 </a>
514 </li>
515
516
517 </ul>
518 </nav>
519 </li>
520
521
522 </ul>
523</nav>
524 </div>
525 </div>
526 </div>
527
528
529 <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
530 <div class="md-sidebar__scrollwrap">
531 <div class="md-sidebar__inner">
532
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]533<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]534
535
536
537
538
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]539 <label class="md-nav__title" for="__toc">
540 <span class="md-nav__icon md-icon"></span>
541 Table of contents
542 </label>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]543 <ul class="md-nav__list" data-md-scrollfix>
544
545 <li class="md-nav__item">
546 <a href="#what-information-is-required" class="md-nav__link">
547 What information is required?
548 </a>
549
550</li>
551
552 <li class="md-nav__item">
553 <a href="#capturing-logcat" class="md-nav__link">
554 Capturing logcat
555 </a>
556
557</li>
558
559 <li class="md-nav__item">
560 <a href="#drivers" class="md-nav__link">
561 Drivers
562 </a>
563
564</li>
565
566 <li class="md-nav__item">
567 <a href="#im-done-where-should-i-send-this-to" class="md-nav__link">
568 I'm done, where should I send this to?
569 </a>
570
571</li>
572
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]573 </ul>
574
575</nav>
576 </div>
577 </div>
578 </div>
579
580
581 <div class="md-content">
582 <article class="md-content__inner md-typeset">
583
584
585
586 <h1 id="taking-bug-reports">Taking bug reports</h1>
587<div class="admonition warning">
588<p class="admonition-title">Warning</p>
589<p>If you were redirected here from Telegram, <strong>please</strong> read this entire page in full! We cannot help you if you submit an incomplete bug report.</p>
590</div>
591<h2 id="what-information-is-required">What information is required?</h2>
592<p>As stated in the XDA post and various "Update" posts, we require some debugging information in order to help troubleshoot your issue.</p>
593<p>When you are asking for help on any of the platforms we are on, such as Telegram or XDA, we ask that you provide the following information:
594 - Device details (as much info about your device as possible)
595 - The exact filename of the Bliss OS <code>.iso</code> file used for installation
596 - Logs from Android <code>logcat</code></p>
597<p>The last bit is <strong>extremely important</strong>! We're not psychics, and certainly not psychics capable of debugging binary issues over the air. Without logs, we don't know what your device is trying to do, or rather, failing to do. So here is a brief rundown on the process of capturing logs.</p>
598<h2 id="capturing-logcat">Capturing logcat</h2>
599<div class="admonition question">
600<p class="admonition-title">Question</p>
601<p><strong>Q: Can I follow the instructions below, but use local terminals?</strong></p>
602<p>Yes, but <strong>only</strong> if you have <strong>root permissions</strong>. We include a default terminal app that you can enable by going to Developer Options. There's also a Terminal Emulator app available on Google Play.</p>
603</div>
604<p>If you would rather not use a terminal app, you can use another virtual console (<code>tty</code>) in order to troubleshoot. Linux has multiple virtual consoles that you can navigate by using shortcuts. On Bliss OS, we use the Alt key and the corresponding function keys (F1 for root terminal, F7 for GUI, etc.) to navigate those virtual consoles.</p>
605<p>Start off by entering the root terminal (Alt-F1). Then type:</p>
606<pre><code>su
607logcat &gt; sdcard/logcat.txt
608</code></pre>
609<p>Then come back to the GUI (Alt-F7) and repeat what caused your issue. Once done, return to the root terminal and end the log collection by pressing Ctrl-C.</p>
610<p>Then grab the <code>logcat.txt</code> file from your root directory (<code>/sdcard</code>) and share it with us in order for us to help you!</p>
611<h2 id="drivers">Drivers</h2>
612<p>If your device already runs well on a Linux distro, sharing information about that distro with us may help us debug driver issues.</p>
613<h2 id="im-done-where-should-i-send-this-to">I'm done, where should I send this to?</h2>
614<p>Our <a href="https://t.me/blissx86">Telegram chat for Bliss OS would be a good place to send bug reports!</a></p>
615<p>We are working on an official bug-tracker, it's not ready just yet. If we make it available we will update the documentation!</p>
616
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]617
618
619
620
621
622
623 </article>
624 </div>
625 </div>
626 </main>
627
628
629<footer class="md-footer">
630
631 <div class="md-footer-nav">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]632 <nav class="md-footer-nav__inner md-grid" aria-label="Footer">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]633
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]634 <a href="../installation-guide/" title="Installation Guide" class="md-footer-nav__link md-footer-nav__link--prev" rel="prev">
635 <div class="md-footer-nav__button md-icon">
636 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]637 </div>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]638 <div class="md-footer-nav__title">
639 <div class="md-ellipsis">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]640 <span class="md-footer-nav__direction">
641 Previous
642 </span>
643 Installation Guide
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]644 </div>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]645 </div>
646 </a>
647
648
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]649 <a href="../troubleshooting/" title="Troubleshooting" class="md-footer-nav__link md-footer-nav__link--next" rel="next">
650 <div class="md-footer-nav__title">
651 <div class="md-ellipsis">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]652 <span class="md-footer-nav__direction">
653 Next
654 </span>
655 Troubleshooting
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]656 </div>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]657 </div>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]658 <div class="md-footer-nav__button md-icon">
659 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4z"/></svg>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]660 </div>
661 </a>
662
663 </nav>
664 </div>
665
666 <div class="md-footer-meta md-typeset">
667 <div class="md-footer-meta__inner md-grid">
668 <div class="md-footer-copyright">
669
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]670 Made with
671 <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
672 Material for MkDocs
673 </a>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]674 </div>
675
676 </div>
677 </div>
678</footer>
679
680 </div>
681
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]682 <script src="../../assets/javascripts/vendor.77e55a48.min.js"></script>
683 <script src="../../assets/javascripts/bundle.aa3f9871.min.js"></script><script id="__lang" type="application/json">{"clipboard.copy": "Copy to clipboard", "clipboard.copied": "Copied to clipboard", "search.config.lang": "en", "search.config.pipeline": "trimmer, stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.result.placeholder": "Type to start searching", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.term.missing": "Missing"}</script>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]684
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]685 <script>
686 app = initialize({
687 base: "../..",
688 features: [],
689 search: Object.assign({
690 worker: "../../assets/javascripts/worker/search.4ac00218.min.js"
691 }, typeof search !== "undefined" && search)
692 })
693 </script>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]694
695
696 </body>
697</html>