1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
|
Introduction
============
A simple GNOME 3 application to access remote or virtual systems.
Goals
=====
* View, access, and use:
* remote machines
* remote virtual machines
* local virtual machines
* When technology permits, set up access for applications on local virtual machines
* View, access, and use virtual machines on removable media
* View, access, and use shared connection / machines
* Share connections?
* Upload / publish virtual machines
* Select favorites
* Search for connections
Non-Goals
=========
* Enterprise system management / administration
* Asset management
* Software distribution
* Automation
Use Cases
=========
* Connect to a local virtual machine for testing.
* Connecting to a work machine from home.
* Connect to a work machine over a low quality cellular network.
Runtime Dependencies
====================
* mcopy (usually provided by mtools package)
Reporting Bugs
==============
If you want to report bugs, please check if there isn't already one on:
https://bugzilla.gnome.org/buglist.cgi?quicksearch=product%3A%22gnome-boxes%22
If one does not exist already, please file a new one.
Please provide as much useful information as you can and have. This can
include
* steps to reproduce your problem
* the error message, if there is one (in the UI and on the console)
* a backtrace if the program crashes (See Appendix 1)
* debug messages if it makes sense (See Appendix 2)
* a fix if you have one (This greatly increases the chances of this issue
getting fixed soon. See HACKING, section 2 for how to provide a good patch.)
The determination of what is useful is your task. If you forget about
something important, someone will probably ask.
Appendix
========
1. Backtracing
--------------
just run
jhbuild run gdb gnome-boxes
Type
run
Let the program crash.
Type:
backtrace
And copy the output to pastebin.com or a similar webpage and link it in the
bugtracker with a hint.
2. Activating debug messages
----------------------------
To run Boxes with debug message output on the console, just run:
G_MESSAGES_DEBUG=Boxes gnome-boxes
If you want to run your jhbuild version, execute:
G_MESSAGES_DEBUG=Boxes jhbuild run gnome-boxes
or start a shell under jhbuild environment:
G_MESSAGES_DEBUG=Boxes jhbuild shell
to be able to use simpler commands from there:
gnome-boxes
3. References
-------------
* https://live.gnome.org/ThreePointThree/Features/Boxes
* https://live.gnome.org/Design/Apps/Boxes
|
