Difference between revisions of "Dustjacket"

From PC-BSD Wiki
Jump to: navigation, search
m
m
Line 8: Line 8:
 
|-
 
|-
 
|
 
|
{{flatten|Preface}}
+
{{:Preface}}
{{flatten|Introduction}}
+
{{:Introduction}}
{{flatten|PC-BSD's Goals and Features}}
+
{{:PC-BSD's Goals and Features}}
{{flatten|What's New in 9}}
+
{{:What's New in 9}}
{{flatten|PC-BSD Releases}}
+
{{:PC-BSD Releases}}
{{flatten|PC-BSD for Linux Users}}
+
{{:PC-BSD for Linux Users}}
{{flatten|Pre-Installation Tasks}}
+
{{:Pre-Installation Tasks}}
{{flatten|Migrating to PC-BSD}}
+
{{:Migrating to PC-BSD}}
{{flatten|Minimum Hardware Requirements}}
+
{{:Minimum Hardware Requirements}}
{{flatten|Hardware Compatibility}}
+
{{:Hardware Compatibility}}
{{flatten|Laptops}}
+
{{:Laptops}}
{{flatten|Partitioning the Hard Drive}}
+
{{:Partitioning the Hard Drive}}
{{flatten|Obtaining PC-BSD}}
+
{{:Obtaining PC-BSD}}
{{flatten|Burning the Installation Media}}
+
{{:Burning the Installation Media}}
{{flatten|PC-BSD Live Mode}}
+
{{:PC-BSD Live Mode}}
{{flatten|Using VirtualBox}}
+
{{:Using VirtualBox}}
{{flatten|Installing PC-BSD}}
+
{{:Installing PC-BSD}}
{{flatten|Starting the PC-BSD Installation}}
+
{{:Starting the PC-BSD Installation}}
{{flatten|Language Selection Screen}}
+
{{:Language Selection Screen}}
{{flatten|Keyboard Selection Screen}}
+
{{:Keyboard Selection Screen}}
{{flatten|System Selection Screen}}
+
{{:System Selection Screen}}
{{flatten|Disk Selection Screen}}
+
{{:Disk Selection Screen}}
{{flatten|Users Creation Screen}}
+
{{:Users Creation Screen}}
{{flatten|Desktop Selection Screen}}
+
{{:Desktop Selection Screen}}
{{flatten|Applications Selection Screen}}
+
{{:Applications Selection Screen}}
{{flatten|Installation Summary Screen}}
+
{{:Installation Summary Screen}}
{{flatten|Installation Progress Screen}}
+
{{:Installation Progress Screen}}
{{flatten|Installation Finished Screen}}
+
{{:Installation Finished Screen}}
{{flatten|Post Installation}}
+
{{:Post Installation}}
{{flatten|Installation Troubleshooting}}
+
{{:Installation Troubleshooting}}
{{flatten|Advanced Installation Topics}}
+
{{:Advanced Installation Topics}}
{{flatten|Use PC-BSD Installer to Install FreeBSD}}
+
{{:Use PC-BSD Installer to Install FreeBSD}}
{{flatten|Install PC-BSD Over a Network}}
+
{{:Install PC-BSD Over a Network}}
{{flatten|Using a Custom Partition Layout}}
+
{{:Using a Custom Partition Layout}}
{{flatten|Disk Encryption}}
+
{{:Disk Encryption}}
{{flatten|Dual Booting}}
+
{{:Dual Booting}}
{{flatten|Upgrading PC-BSD}}
+
{{:Upgrading PC-BSD}}
{{flatten|Creating an Automated Installation with pc-sysinstall}}
+
{{:Creating an Automated Installation with pc-sysinstall}}
{{flatten|Desktops}}
+
{{:Desktops}}
{{flatten|GNOME2}}
+
{{:GNOME2}}
{{flatten|KDE4}}
+
{{:KDE4}}
{{flatten|LXDE}}
+
{{:LXDE}}
{{flatten|XFCE4}}
+
{{:XFCE4}}
{{flatten|Awesome}}
+
{{:Awesome}}
{{flatten|Fluxbox}}
+
{{:Fluxbox}}
{{flatten|FVWM}}
+
{{:FVWM}}
{{flatten|IceWM}}
+
{{:IceWM}}
{{flatten|Openbox}}
+
{{:Openbox}}
{{flatten|ScrotWM}}
+
{{:ScrotWM}}
{{flatten|Window Maker}}
+
{{:Window Maker}}
{{flatten|Installing Applications and Keeping PC-BSD Updated}}
+
{{:Installing Applications and Keeping PC-BSD Updated}}
{{flatten|Using AppCafe™}}
+
{{:Using AppCafe™}}
{{flatten|PBI Manager}}
+
{{:PBI Manager}}
{{flatten|Update Manager}}
+
{{:Update Manager}}
{{flatten|Control Panel}}
+
{{:Control Panel}}
{{flatten|Ports Jail}}
+
{{:Ports Jail}}
{{flatten|Service Manager}}
+
{{:Service Manager}}
{{flatten|System Manager}}
+
{{:System Manager}}
{{flatten|User Manager}}
+
{{:User Manager}}
{{flatten|Display}}
+
{{:Display}}
{{flatten|Printing}}
+
{{:Printing}}
{{flatten|Network Configuration}}
+
{{:Network Configuration}}
{{flatten|Firewall Manager}}
+
{{:Firewall Manager}}
{{flatten|Life Preserver}}
+
{{:Life Preserver}}
{{flatten|Warden™}}
+
{{:Warden™}}
{{flatten|Thin Client}}
+
{{:Thin Client}}
{{flatten|Common Tasks}}
+
{{:Common Tasks}}
{{flatten|Java, Flash, and Fonts}}
+
{{:Java, Flash, and Fonts}}
{{flatten|Multimedia}}
+
{{:Multimedia}}
{{flatten|MythTV}}
+
{{:MythTV}}
{{flatten|XBMC}}
+
{{:XBMC}}
{{flatten|Windows Emulation}}
+
{{:Windows Emulation}}
{{flatten|Files and File Sharing}}
+
{{:Files and File Sharing}}
{{flatten|Remote Desktop}}
+
{{:Remote Desktop}}
{{flatten|Media Streaming}}
+
{{:Media Streaming}}
{{flatten|Video Conferencing}}
+
{{:Video Conferencing}}
{{flatten|Security}}
+
{{:Security}}
{{flatten|Finding Help}}
+
{{:Finding Help}}
{{flatten|PC-BSD Forums}}
+
{{:PC-BSD Forums}}
{{flatten|IRC Channel}}
+
{{:IRC Channel}}
{{flatten|Mailing Lists}}
+
{{:Mailing Lists}}
{{flatten|FreeBSD Handbook and FAQ}}
+
{{:FreeBSD Handbook and FAQ}}
{{flatten|Social Media}}
+
{{:Social Media}}
{{flatten|Search and Portals}}
+
{{:Search and Portals}}
{{flatten|Other Resources}}
+
{{:Other Resources}}
{{flatten|Supporting PC-BSD}}
+
{{:Supporting PC-BSD}}
{{flatten|Become a Beta Tester}}
+
{{:Become a Beta Tester}}
{{flatten|Become a Translator}}
+
{{:Become a Translator}}
{{flatten|Become a Developer}}
+
{{:Become a Developer}}
{{flatten|Report Bugs}}
+
{{:Report Bugs}}
{{flatten|Submit PBI Requests}}
+
{{:Submit PBI Requests}}
{{flatten|Test PBIs}}
+
{{:Test PBIs}}
{{flatten|Create PBIs}}
+
{{:Create PBIs}}
{{flatten|Purchase PC-BSD Swag}}
+
{{:Purchase PC-BSD Swag}}
{{flatten|Host a Mirror}}
+
{{:Host a Mirror}}
{{flatten|Seed a Torrent}}
+
{{:Seed a Torrent}}
{{flatten|Become an Advocate}}
+
{{:Become an Advocate}}
 
|}
 
|}

Revision as of 16:13, 16 January 2012


Contents

Dustjacket/content/en

References


Introduction

NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
Goals and Features
Upcoming (10.1.2)
Goals and Features


The following features have been added to or improved for PC-BSD® 9.1:

  • Based on FreeBSD 9.1, which includes improved Intel video support. The Release Notes for FreeBSD 9.1[1] list the new features and drivers introduced in FreeBSD 9.1.
  • The PC-BSD® installer has been revamped to separate pre-installation tasks from post-installation tasks. This makes it easier to automate the roll-out of multiple installations because the end-user can configure their account information and display settings before logging in for the first time.
  • The PC-BSD® installer now sets its default settings according to the hardware installed. 64-bit systems containing over 2GB of RAM will default to the ZFS filesystem whereas 32-bit systems and any system containing less than 2GB of RAM will default to UFS+SUJ. Systems containing more than 2GB of RAM will default to the KDE desktop and all other systems will default to the LXDE desktop. A hardware compatibility icon within the installer allows the user to see at a glance if their video card, Ethernet card, wireless card, and sound card are compatible with PC-BSD®.
  • The ability to perform a network install has been removed from the graphical installer. The scriptable back-end still provides the variables needed for network installations.
  • The ZFS section of the PC-BSD® installer now allows you to set ZFS properties such as compression and quotas, create datasets, and import existing ZFS pools.
  • Multiple Boot Environments support allows systems formatted with ZFS to create alternate bootable snapshots. These can be used for testing purposes or to create a bootable backup of the boot environment before performing an upgrade.
  • Warden® is now built into the operating system and available through Control Panel. It can now be used to manage multiple jails.
  • Warden® now supports the creation of three types of jails: traditional FreeBSD jails for running network services, (a less secure) ports jail for safely installing and running FreeBSD ports/packages from your PC-BSD® system, and the installation of Linux within a jail.
  • Warden® now supports the management of ZFS snapshots on a per-jail basis.
  • Update Manager has been integrated into Warden®. Combined with the meta-package support, it is now easier than ever to install software into a jail and to keep that software up-to-date.
  • AppCafe® now shows the number of available PBIs and supports automatic updating.
  • EasyPBI is now available through Control Panel, making it easier than ever to convert existing FreeBSD ports to PC-BSD® PBIs.
  • An About icon has been added to the Control Panel, making it easy to determine the PC-BSD® version, which desktops, and the version of X that have been installed.
  • An Active Directory & LDAP GUI has been added to Control Panel, allowing you to set the client information for connecting to Active Directory servers.
  • A Hardware Compatibility icon has been added to the control panel, providing a quick overview of detected hardware devices.
  • The GDM Configuration GUI has been added to Control Panel and can be used to configure auto-login and remote login through XDMCP.
  • A Mount Tray icon has been added to the Control Panel and System Tray, allowing easy access to USB drives.
  • A Sound Configuration icon has been added to the Control Panel and can be used to test sound or change the default audio device.
  • Life Preserver now provides a browse button when creating an include or exclude filter.
  • Thin Client now allows you to create a PXE Boot Desktop Server or a PXE Boot Installation Server.
  • When ZFS formatting during installation, gnop 4K alignment[2] is now used when creating the zpool. This results in a dramatic increase in performance. For this reason, it is recommended that users with existing ZFS installations re-install rather than upgrade in order to receive these performance benefits.



NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
PC-BSD® Releases
Upcoming (10.1.2)
PC-BSD® Releases


NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
PC-BSD® for Linux Users
Upcoming (10.1.2)
PC-BSD® for Linux UsersPre-Installation Tasks

Migrating to PC-BSD

NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
Hardware Requirements
Upcoming (10.1.2)
Hardware RequirementsHardware Compatibility

Laptops Partitioning the Hard Drive

NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
Obtaining PC-BSD®
Upcoming (10.1.2)
Obtaining PC-BSD®Burning the Installation Media
NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
PC-BSD® Live Mode

(Sorry, this does not exist for 10.1.2)Using VirtualBox

NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
Installing PC-BSD®
Upcoming (10.1.2)
Installing PC-BSD®


NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
Starting the PC-BSD® Installation

(Sorry, this does not exist for 10.1.2)Language Selection Screen

The next screen, seen in Figure 3.3a, allows you to change your keyboard model, keyboard layout, and preferred variant. If English is your native language and you are using a basic English keyboard, you can just press Next to accept the defaults.

Otherwise, use the menus to change the default selection(s) to match your keyboard type and language. You can test your changes by typing into the white area at the bottom of the screen, just below the message that indicates you can test your selected settings.

Figure 3.3a: Keyboard Setup Screen Allows you to Select your Keyboard Model, Layout, and Variant

Figure3.3a.jpeg <noinclude.</noinclude> System Selection Screen Disk Selection Screen

NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
Create a User Screen
Upcoming (10.1.2)
Create a User Screen


NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
System Selection Screen
Upcoming (10.1.2)
System Selection Screen


The Sources Selection screen, seen in Figure 3.8a, allows advanced users to install FreeBSD source or the FreeBSD ports collection. These can also be installed after installation using the "System Tasks - Advanced Users" section of Control Panel System ManagerTasks.

Figure 3.8a: Sources Selection Screen

Figure3.8a.jpeg

Highlight the FreeBSD component that you would like to install in the "Available" box and click the blue > button to add it to the "Selected" box. If you change your mind, highlight the item in the "Selected" box and click the blue < button. Whatever shows up in the "Selected" box when you click the Next button, will be installed for you.


Installation Summary Screen Installation Progress Screen Installation Finished Screen

NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
Booting Into PC-BSD®
Upcoming (10.1.2)
Booting Into PC-BSD®Installation Troubleshooting

Advanced Installation Topics

NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
Install a Server
Upcoming (10.1.2)
Install a ServerInstall PC-BSD Over a Network

Using a Custom Partition Layout Disk Encryption Dual Booting

NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
Upgrading PC-BSD®
Upcoming (10.1.2)
Upgrading PC-BSD®Creating an Automated Installation with pc-sysinstall

Dustjacket/10.1.1

GNOME2 KDE4 LXDE XFCE4 Awesome Fluxbox FVWM IceWM Openbox

NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
Spectrwm
Upcoming (10.1.2)
SpectrwmWindow Maker
NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
Installing Applications and Keeping PC-BSD® Updated
Upcoming (10.1.2)
Installing Applications and Keeping PC-BSD® UpdatedUsing AppCafe™

Dustjacket/10.1.1


Dustjacket/10.1.1


Dustjacket/10.1.1

Ports Jail Service Manager

Dustjacket/10.1.1


Dustjacket/10.1.1

Display Printing

Dustjacket/10.1.1


Dustjacket/10.1.1


Dustjacket/10.1.1


NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
Warden®
Upcoming (10.1.2)
Warden®Thin Client
NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
Using PC-BSD®
Upcoming (10.1.2)
Using PC-BSD®Java, Flash, and Fonts

Multimedia MythTV XBMC Windows Emulation Files and File Sharing Remote Desktop

{{{subject}}}Stub icon
This Handbook article about Dustjacket is a Stub. You can help the PC-BSD wiki by expanding it.


VLC - Possibly would work after installing on both machines?

http://wiki.freebsd.org/VDR


{{{subject}}}Stub icon
This handbook article about Dustjacket is a Stub. You can help the PC-BSD wiki by expanding it.


Webcamd

use mplayer to access webcam:

mplayer -cache 128 -tv driver=v4l:width=640:height=480:outfmt=i420:device=/dev/video0 -vc rawi420 -vo xv tv://

BBB

Security

Dustjacket/content/en

References



NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
PC-BSD® Forums
Upcoming (10.1.2)
PC-BSD® Forums


Dustjacket/content/en

References



Dustjacket/content/en

References



Dustjacket/content/en

References



Dustjacket/content/en

References



Dustjacket/content/en

References



Dustjacket/content/en

References



NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
Supporting PC-BSD®
Upcoming (10.1.2)
Supporting PC-BSD®Dustjacket/content/en


<translate> Dustjacket/10.1.1 </translate>

Introduction

If you like programming, and especially coding on FreeBSD, we would love to see you join the PC-BSD® Team as a PC-BSD® committer. Developers who want to help improve the PC-BSD® codebase are always welcome! If you would like to participate in core development, subscribe to the developers mailing list[3]. Once you have signed up, feel free to browse the active tickets in the PC-BSD® Bug database[4]. If you see something that you want to work on, or have a proposal for a project you wish to add to PC-BSD®, please let us know via the developers list and we will be happy to help get you started.

Most of the PC-BSD® specific GUI tools are developed in C++ using the Qt Libraries, and other non-GUI development is done using standard Bourne shell scripts. There may be cases where other languages or libraries are needed, but those will be evaluated on a case-by-case basis, so feel free to let us know your proposals on the developers mailing list.

Getting the Source Code and Development Tools

The PC‑BSD® source code is available from github and git needs to be installed in order to download the source code. When using PC‑BSD®, git is included in the base install.

To download the source code, cd to the directory to store the source and type:

git clone git://github.com/pcbsd/pcbsd.git

This will create a directory named pcbsd/ which contains the local copy of the repository. To keep the local copy in sync with the official repository, run git pull within the pcbsd directory.

PC‑BSD® graphical applications use Qt version 5 and their source is located in pcbsd/src-qt5/. In order to compile the applications in this directory, install the "PC-BSD Build ToolChain" PBI using AppCafe®. To instead install this PBI from the command line, type pbi add devel/pcbsd-toolchain.

Most of the PC‑BSD® source code is divided into two sub-categories:

  • src-sh/ contains shell and C programs which do not include GUIs. These are the command line utilities used in TrueOS® and PC-BSD® and which are installed by the FreeBSD ​sysutils/pcbsd-utils port.
  • src-qt5/ contains the Qt5-based GUIs seen in PC-BSD® and which are installed by the ​FreeBSD sysutils/pcbsd-utils-qt5 port

To compile the command line utilities:

cd src-sh

make

To compile the graphical utilities:

cd src-qt4

/usr/local/lib/qt5/bin/qmake

make

Several Qt IDEs are available in AppCafe®. The "QtCreator[5] PBI is a full featured IDE designed to help new Qt users get up and running faster while boosting the productivity of experienced Qt developers. Qt Designer[6] is lighter weight as it is only a .ui file editor and does not provide any other IDE functionality. It can be installed as the "qt5-designer" raw package using AppCafe® or pkg install.

If you plan to submit changes so that they can be included in PC-BSD®, fork the repository using the instructions at Fork a repo[7]. Make your changes to the fork, then submit them by issuing a git pull request[8]. Once your changes have been reviewed, they will be committed or sent back with suggestions.

Basic Guidelines for Writing a PC‑BSD® Utility

PC‑BSD® is a community driven project that relies on the support of developers in the community to help in the design and implementation of new utilities and tools for PC‑BSD®. Going forward, we aim to present a unified design so that programs feel "familiar" to users. As an example, while programs could have "File", "Main", or "System" as their first entry on the "File menu", we want to present one option, "File", as it is the accepted norm for the first category on the menu bar.
Figure  Is there no version? a: AppCafe® File Menu

This section describes a small list of guidelines to menu and program design in PC‑BSD®. Since most programs designed for the last couple of decades have followed this structure, it makes sense for us to follow the same standard.

File Menus

Any graphical program that is a full-featured utility, such as Warden® or AppCafe®, should have a file menu. However, file menus are not necessary for small widget programs or dialogue boxes. When making a file menu, a good rule of thumb is keep it simple. Most PC‑BSD® utilities do not need more than two or three items on the file menu. An example of a well laid out "File" menu is AppCafe®, shown in Figure  Is there no version? a.

"Configure" is our adopted standard for the category that contains "Settings" or other configuration related settings. If additional categories are needed, check to see what other PC‑BSD® utilities are using.

File Menu Icons

File menu icons are taken from the KDE "Oxygen" theme located in /usr/local/share/icons/oxygen. Use these file menu icons so we do not have a bunch of different icons used for the same function. Table  Is there no version? a lists the commonly used icons and their default file names.


Table  Is there no version? a: Commonly Used File Menu Icons [Tables 1]
Function File Menu Icon File Name
Quit row 1, cell 2 window-close.png
Settings row 2, cell 2 configure.png

Buttons

PC‑BSD® utilities use these buttons as follows:

  • Apply: applies settings and leaves the window open.
  • Close: closes program without applying settings.
  • OK: closes dialogue window and saves settings.
  • Cancel: closes dialogue window without applying settings.
  • Save: saves settings and closes window.

Fully functional programs like AppCafe® and Warden® do not use close buttons on the front of the application. Basically, whenever there is a "File" menu, that and an x in the top right corner of the application are used instead. Dialogues and widget programs are exceptions to this rule. A good example of a widget program would be Update Manager.

Keyboard Shortcuts

Many users benefit from keyboard shortcuts and we aim to make them available in every PC‑BSD® utility. Qt makes it easy to assign keyboard shortcuts. For instance, to configure keyboard shortcuts that browse the "File" menu, put &File in the text slot for the menu entry when making the application. Whichever letter has the & symbol in front of it will become the hot key. You can also make a shortcut key by clicking the menu or submenu entry and assigning a shortcut key. Be careful not to duplicate hot keys or shortcut keys. Every key in a menu and submenu should have a key assigned for ease of use and accessibility. Tables  Is there no version? b and  Is there no version? c summarize the commonly used shortcut and hot keys.

Table  Is there no version? b: Shortcut Keys [Tables 2]
Shortcut Key Action
CTRL + Q Quit
F1 Help


Table  Is there no version? c: Hot Keys [Tables 3]
Hot Key Action
Alt + Q Quit
Alt + S Settings
Alt + I Import
Alt + E Export
ALT + F File Menu
ALT + C Configure Menu
ALT + H Help Menu

Saving Settings in a Qt Application

When saving an application's settings, the QSettings class should be used if possible. There are two different "organizations", depending on whether the application is running with root permissions or user permissions. Use "PCBSD" for the organization for applications that run with user permissions and "PCBSD-root" for applications that are started with root permissions via sudo. Proper use prevents the directory where settings files are saved from being locked down by root applications, allowing user applications to save and load their settings. Examples  Is there no version? a and  Is there no version? b demonstrate how to use the QSettings class for each type of permission.

Example  Is there no version? a: User Permission Settings

(user application - C++ code): QSettings settings("PCBSD", "myapplication");

Example  Is there no version? b: Root Permission Settings

(root application - C++ code): QSettings settings("PCBSD-root", "myapplication");

Resources

Developers will also find the following resources helpful:



Have you found a bug in PC-BSD®? If so, please take the time to read through this section to ensure that your bug gets reported to the correct group and is resolved in a timely fashion.

First, determine the type of bug that you are encountering. Is it a bug that is preventing you from properly installing and running PC-BSD® (a system bug), or is it an issue with an installed software package such as FireFox (an application bug)?

An application bug can fall into a few different categories.

Application Packaging Bug

The first is a packaging bug, which is when you can not install the application or it simply crashes on startup. Please report these types of bugs by logging into the Bugs Database[12] and creating a new "PBI Packaging" issue. Select/enter the operating system version you are using. Use descriptive words in the "Summary". In the "Description", provide as much detail as possible about the bug, such as:

  • the name of the program
  • a detailed description of the bug, including any error messages and which commands or menus you used to generate the error

If you would like to include a screenshot of the error or a log that includes error messages, check the box "I have files to attach to this ticket" to browse to the location of the attachment. Use the "Preview" button to read through your ticket to make sure that the information is clear to the person who will resolve the issue. When finished, click the "Create ticket" button to submit your bug report.

Application Runtime Bug

An application runtime bug occurs when an application installs and is able to start successfully, but during use, it crashes or exhibits some other type of undesired behavior. An example would be OpenOffice failing to import a type of document properly or a chat client unable to keep a connection to a network.

If you installed the application using AppCafe® and you think that the problem is related to how the PBI was packaged, report the bug on the PBI Discussion Forum[13]. If you suspect that the problem is with the underlying FreeBSD port, you can use FreshPorts.org to determine the email address of the port maintainer. If you do email the port maintainer, indicate the name of the port, any error messages that you receive and how to reproduce the bug, and indicate if you are able to assist the maintainer in testing any patches to the port. Once the port is fixed, let the PBI Discussion Forum know so that the PBI can be rebuilt using the fixed port.

System Driver Bugs

A system bug is any bug which prevents the initial installation of PC-BSD®, or causes issues with hardware. Some examples would be a non-bootable system, failed installation, missing drivers for your hardware, or a non-functional desktop after installation. To report this type of issue please follow the instructions below for your type of system bug.

An example of a system driver bug would be a missing network driver, no sound output, or no disk drives detected. Most of these types of issues are directly related to the FreeBSD base upon which PC-BSD® is built, and are best fixed by discussing them with the FreeBSD team directly. Reporting a bug to FreeBSD can be done using the Send PR[14] page. You should also search the FreeBSD mailing lists as other users may have already discovered the bug or have a work-around for your particular hardware. Below are some of the related mailing lists:

  • ACPI[15]: power management and ACPI development
  • Emulation[16]: place to discuss Linux, VirtualBox, Wine and Linux Flash plugin support
  • USB[18]: USB support and development
  • Xorg[19]: Xorg and video drivers and development

System Installation Bugs

Any bugs encountered during the installation of PC-BSD® should be reported to the Bugs Database[20], with as much detail as possible, including:

  • PC-BSD® version
  • hardware information, disk and partition sizes, amount of RAM and CPU
  • description of any defaults that you changed using the installer's "Customize" button
  • attach a copy of your saved /tmp/pc-sysinstall.log; if you did not save it during the installation, a copy was saved for you to /root/pc-sysinstall.log


Submit PBI Requests Test PBIs

<translate> Dustjacket/10.1.2 </translate>

NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

Which would you like?

Release (10.1.1)
Purchase PC-BSD® Swag
Upcoming (10.1.2)
Purchase PC-BSD® Swag



NOTE: In late 2013 PC-BSD switched to a CDN for its file-distribution.

http://iso.cdn.pcbsd.org
http://pkg.cdn.pcbsd.org
http://pbi.cdn.pcbsd.org




PC-BSD® is also distributed as a torrent[21] and you can increase download speeds for other users by seeding, especially during the first two weeks after a new release. If you are new to seeding, read through the GotBSD FAQ[22] first.

The Network-P2P category of AppCafe® provides several torrent utilities including:


Become an Advocate


Cite error: <ref> tags exist, but no <references/> tag was found
Cite error: <ref> tags exist for a group named "Tables", but no corresponding <references group="Tables"/> tag was found
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox