Thursday, October 22, 2015

Git

--BEGIN--
GitLab
----
Create, review and deploy code together
----
GitLab CE (Community Edition)
GitLab EE (Enterprise Edition)
GitLab.com (On Our Server)
----
git repository management
code reviews
issue tracking
CI: continuous integration
deployment tool
----
Start using Git on the commandline
Create an account on GitLab.com.
----
Find the shell of your preference.
・Terminal on Mac OSX
・GitBash on Windows
・Linux Terminal on Linux
----
Check if Git has already been installed:
Git is usually preinstalled on Mac and Linux.
git --version
If you don't receive a "Git version" message, you need to download Git.
----
Add your Git username and set your email.
Every Git commit that you create will use this information.
To add your username:
git config --global user.name ADD YOUR USERNAME

To verify your username:
git config --global user.name

To set your email address:
git config --global user.email ADD YOUR EMAIL

To verify your email:
git config --global user.email

--global:  It tells Git to always use this information for anything you do on that system.
If you want to override this with a different username or email address for specific projects, you can run the command without the "--global" option when you're in that project.

To view the information:
git config --global --list
----
How to create your SSH Keys
You need to connect your computer to your GitLab account through SSH Keys. They are unique for every computer that you link your GitLab account with.

Generate your SSH Key
Create an account on GitLab.
Sign up and check your email for your confirmation link.
After you confirm, go to GitLab.com and sign in to your account

Add your SSH Key
Click on "profile settings"
Click on "SSH Keys"
Click on  "Add SSH Key"
Paste the SSH Key that your commandline will generate for you.
----
When you copy a project you say you "clone" it.
To work on a git project locally (from your own computer), you will need to clone it. To do this, sign in to GitLab.com
When you are on your Dashboard, click on the project that you'd like to clone, which you'll find at the right side of your screen
To work in the project, you can copy a link to the Git repository through a SSH or a HTTPS protocol.
SSH is easier to use after it's been setup.
When you're in the project, click on the HTTPS or SSH button at the right side of your screen.
Then copy the link (you'll have to paste it on your shell in the next step)

On the command line
To clone your project, go to your computer's shell and type the following command:
git clone PASTE HTTPS OR SSH HERE

Go into a project, directory or file to work in it:
cd NAME-OF-PROJECT-OR-FILE
Go back one directory or file:
cd ../
To see what's in the directory that you are in:
ls
Create a directory:
mkdir NAME-OF-YOUR-DIRECTORY
Create a README.md or file in directory:
touch README.md
nano README.md
#### ADD YOUR INFORMATION
#### Press: control + X
#### Type: Y
#### Press: enter
Remove a file:
rm NAME-OF-FILE
Remove a directory and all of its contents:
rm -rf NAME-OF-DIRECTORY
View history in the command line:
history
Carry out commands for which the account you are using lacks authority. (You will be asked for an administrator's password):
sudo
----
Basic Git commands

Go to the master branch to pull the latest changes from there:
git checkout master

Download the latest changes in the project, so that you work on an up-to-date copy (this is important to do every time you work on a project), while you setup tracking branches:
git pull REMOTE NAME-OF-BRANCH -u
(REMOTE: origin) (NAME-OF-BRANCH: could be "master" or an existing branch)

Create a branch (remember that spaces won't be recognized, you need to use a hyphen or underscore):
git checkout -b NAME-OF-BRANCH

Work on a branch that has already been created:
git checkout NAME-OF-BRANCH

To see the changes you've made:
git status

Add changes to commit (you'll be able to see your changes in red when you type "git status"):
git add CHANGES IN RED
git commit -m "DESCRIBE THE INTENTION OF THE COMMIT"

Send changes to gitlab.com:
git push origin NAME-OF-BRANCH

Throw away all changes in the Git repository, but leave unstaged things:
git checkout .

Delete all changes in the Git repository, including untracked files:
git clean -f

Remove all the changes that you don't want to send to gitlab.com:
git add NAME-OF-FILE -all

Merge created branch with master branch. You need to be in the created branch:
git checkout NAME-OF-BRANCH
git merge master
----
Create a project
Sign in to GitLab.com.
Go to your Dashboard and click on "new project" on the right side of your screen.
Fill out the required information.
1. Project path or the name of your project (you can't add spaces, so you can use hyphens or underscores)
2. Your project's description
3. Select a visibility level
4. You can also import your existing projects
5. Click on "create project"
----
Create a group
Your projects in GitLab.com can be organized in 2 different ways:
under your own namespace for single projects, such as ´your-name/project-1'; or under groups.
If you organize your projects under a group, it works like a folder. You can manage your group members' permissions and access to the projects.

To create a group:
Sign in to GitLab.com.
When you are on your Dashboard, click on "Groups" on the left menu of your screen.
Click on "New group" on the top right side of your screen:
Fill out the information required:
1. Add a group path or group name (you can't add spaces, so you can use hyphens or underscores).
2. Add details or a group description.
3. You can choose a group avatar if you'd like.
4. Click on "create group".
----
Add a project to a group
There are 2 different ways to add a new project to a group:
・Select a group and then click on "New project" on the right side of your screen. Then you can create a project。
・When you are creating a project, click on "create a group" on the bottom right side of your screen
----
How to create a branch
A branch is an independent line of development.
New commits are recorded in the history for the current branch, which results in taking the source from someone's repository (the place where the history of your work is stored) at certain point in time, and apply your own changes to it in the history of the project.
To add changes to your GitLab project, you should create a branch. You can do it in your shell or in GitLab.
To create a new branch in GitLab, sign in and then select a project on the right side of your screen:
Click on "commits" on the menu on the left side of your screen:
Click on the "branches" tab:
Click on the "new branch" button on the right side of the screen:
Fill out the information required:
1. Add a name for your new branch (you can't add spaces, so you can use hyphens or underscores)
2. On the "create from" space, add the the name of the branch you want to branch off from
3. Click on the button "create branch"
You will be able to find and select the name of your branch in the white box next to a project's name:
----
How to fork a project
A fork is a copy of an original repository that you can put somewhere else or where you can experiment and apply changes that you can later decide if publishing or not, without affecting your original project.
1. Sign in to GitLab.
2. Select a project on the right side of your screen.
3. Click on the "fork" button on the right side of your screen.
4. Click on the user or group to where you'd like to add the forked project.
----
How to add a file
You can create a file in your shell or in GitLab.
To create a file in GitLab, sign in to GitLab.
Select a project on the right side of your screen:
It's a good idea to create a branch, but it's not necessary.
Go to the directory where you'd like to add the file and click on the "+" sign next to the name of the project and directory:
Name your file (you can't add spaces, so you can use hyphens or underscores). Don't forget to include the markup language you'd like to use :
Add all the information that you'd like to include in your file:
Add a commit message based on what you just added and then click on "commit changes":
Besides its regular files, every directory needs a README.md or README.html file which works like an index, telling what the directory is about. It's the first document you'll find when you open a directory.
----
How to add an image
The following are the steps to add images to your repository in GitLab:
Find the image that you'd like to add.
In your computer files, find the GitLab project to which you'd like to add the image (you'll find it as a regular file). Click on every file until you find exactly where you'd like to add the image. There, paste the image.
Go to your shell, and add the following commands:

Add this command for every directory that you'd like to open:
cd NAME-OF-FILE-YOU'D-LIKE-TO-OPEN

Create a new branch:
git checkout -b NAME-OF-BRANCH

Check if your image was correctly added to the directory:
ls

You should see the name of the image in the list shown.
Move up the hierarchy through directories:
cd ../

Check the status and you should see your image's name in red:
git status

Add your changes:
git add NAME-OF-YOUR-IMAGE

Check the status and you should see your image's name in green:
git status

Add the commit:
git commit -m “DESCRIBE COMMIT IN A FEW WORDS”

Now you can push (send) your changes (in the branch NAME-OF-BRANCH) to GitLab (the git remote named 'origin'):
git push origin NAME-OF-BRANCH

Your image will be added to your branch in your repository in GitLab. Create a Merge Request to integrate your changes to your project.
----
How to create a merge request
Merge Requests are useful to integrate separate changes that you've made to a project, on different branches.
To create a new Merge Request, sign in to GitLab.
Go to the project where you'd like to merge your changes:
Click on "Merge Requests" on the left side of your screen:
Click on "+ new Merge Request" on the right side of the screen:
Select a source branch or branch:
Click on the "compare branches" button:
Compare branches
Add a title and a description to your Merge Request:
Select a user to review your Merge Request and to accept or close it. You may also select milestones and labels (they are optional). Then click on the "submit new Merge Request" button:
Your Merge Request will be ready to be approved and published.
After you created a new branch, you'll immediately find a "create a Merge Request" button at the top of your screen. You may automatically create a Merge Request from your recently created branch when clicking on this button:
----
Permissions
Users have different abilities depending on the access level they have in a particular group or project.
If a user is both in a project group and in the project itself, the highest permission level is used.
If a user is a GitLab administrator they receive all permissions.

Project
・Guest
・Reporter
・Developer
・Master
・Owner

Group
In order for a group to appear as public and be browsable, it must contain at least one public project.
Any user can remove themselves from a group, unless they are the last Owner of the group.
----
Settings in the Profile > Preferences page allow the user to customize various aspects of the site to their liking.

Application theme
Changing this setting allows the user to customize the color scheme used for the navigation bar on the left side of the screen.
The default is Charcoal.

Syntax highlighting theme
Changing this setting allows the user to customize the theme used when viewing syntax highlighted code on the site.
The default is White.

Behavior
Default Dashboard
For users who have access to a large number of projects but only keep up with a select few, the amount of activity on the default Dashboard page can be overwhelming.
Changing this setting allows the user to redefine what their default dashboard will be. Setting it to Starred Projects will make that Dashboard view the default when signing in or clicking the application logo in the upper left.
The default is Your Projects.

Default Project view
It allows user to choose what content he or she want to see on project page.
The default is Readme.
----
Public access
GitLab allows you to open selected projects to be accessed publicly or internally.
Projects with either of these visibility levels will be listed in the public access directory.
Internal projects will only be available to authenticated users.

Public projects
Public projects can be cloned without any authentication.
It will also be listed on the public access directory.
Any logged-in user will have Guest permissions on the repository.

Internal projects
Internal projects can be cloned by any logged in user.
It will also be listed on the public access directory for logged in users.
Any logged-in user will have Guest permissions on the repository.

How to change project visibility
Go to your project dashboard
Click on the "Edit" tab
Change "Visibility Level"

Visibility of users
The public page of users, located at /u/username is visible if either:
You are logged in.
You are logged out, and the target user is authorized to (is Guest, Reporter, etc.) at least one public project.

Otherwise, you will be redirected to the sign in page.
When visiting the public page of an user, you will only see listed projects which you can view yourself.

Restricting the use of public or internal projects
In the Admin area under Settings you can disable public projects or public and internal projects for the entire GitLab installation to prevent people making code public by accident. The restricted visibility settings do not apply to admin users.
Version control is a system that records changes to a file or set of files over time so that you can recall specific versions later. ----
VCS: Version Control System
----
One of the more popular VCS tools was a system called RCS, which is still distributed with many computers today. Even the popular Mac OS X operating system includes the rcs command when you install the Developer Tools.
----
CVCS: Centralized Version Control Systems
a single server contains all the versioned files, and a number of clients that check out files from that central place.
----
DVCS: Distributed Version Control Systems
clients fully mirror the repository.
----
2005 Git
Linux
----
Git thinks of its data like a set of snapshots of a miniature filesystem. Every time you commit, or save the state of your project in Git, it takes a picture of what all your files look like at that moment and stores a reference to that snapshot.
If files have not changed, Git doesn't store the file again, just a link to the previous identical file it has already stored.
Git thinks about its data like a stream of snapshots.
---
Most operations in Git only need local files and resources to operate – generally no information is needed from another computer on your network.
----
Everything in Git is check-summed before it is stored and is then referred to by that checksum.
This means it's impossible to change the contents of any file or directory without Git knowing about it.
----
The mechanism that Git uses for this checksumming is called a SHA-1 hash. This is a 40-character string composed of hexadecimal characters (0–9 and a–f) and calculated based on the contents of a file or directory structure in Git. A SHA-1 hash looks something like this:
24b9da6552252987aa493b52f8696cd6d3b00373
----
When you do actions in Git, nearly all of them only add data to the Git database. It is hard to get the system to do anything that is not undoable or to make it erase data in any way.
----
Three main states that files can reside in: Committed: data is stored in your local database.
Modified: file changed but not committed to database yet.
Staged: a modified file in its current version marked to go into your next commit snapshot.
----
The three main sections of a Git project:
Git directory
Working directory
staging area
----
Git directory:  the metadata and object database for your project.
Working directory: is a single checkout of one version of the project.
Staging area: a file, contained in your Git directory, that stores information about what will go into your next commit.
----
Git workflow:
1. modify files in your working directory.
2. stage the files, adding snapshots of them to your staging area.
3. do a commit, which takes the files as they are in the staging area and stores that snapshot permanently to your Git directory.
----
configuration variables: control all aspects of how Git looks and operates. These variables can be stored in three different places:
    /etc/gitconfig file: Contains values for every user on the system and all their repositories. If you pass the option --system to git config, it reads and writes from this file specifically.
    ~/.gitconfig or ~/.config/git/config file: Specific to your user. You can make Git read and write to this file specifically by passing the --global option.
    config file in the Git directory (that is, .git/config) of whatever repository you're currently using: Specific to that single repository.
Each level overrides values in the previous level, so values in .git/config trump those in /etc/gitconfig.
----
On Windows systems, Git looks for the .gitconfig file in the $HOME directory (C:\Users\$USER for most people).
It also still looks for /etc/gitconfig, although it's relative to the MSys root, which is wherever you decide to install Git on your Windows system when you run the installer.
However, if you are using Git for Windows 2.x, it is C:\Documents and Settings\All Users\Application Data\Git\config on Windows XP, and it is C:\ProgramData\Git\config on Windows Vista and newer.
----
To set your user name and email address:
git config --global user.name "John Doe"
git config --global user.email johndoe@example.com

If you want to override this with a different name or email address for specific projects, you can run the command without the --global option when you're in that project.
----
To check your settings:
git config --list
----
To check  a specific key's value:
git config [key]

example:
git config user.name
----
To get the manual page:
git help <verb>
git <verb> --help
man git-<verb>

example:
git help config
----
If you're starting to track an existing project in Git, you need to go to the project's directory and type:
git init

This creates a new subdirectory named .git that contains all of your necessary repository files – a Git repository skeleton.
----
If you want to start version-controlling existing files (as opposed to an empty directory), you should begin tracking those files and do an initial commit.
git add *.c
git add LICENSE
git commit -m 'initial project version'
----
To clone (a copy of an existing Git repository):
git clone [url]

example:
git clone https://github.com/libgit2/libgit2

That creates a directory named “libgit2”, initializes a .git directory inside it, pulls down all the data for that repository, and checks out a working copy of the latest version.
----
To clone the repository into a different directory:
git clone [url] [directory]

example:
git clone https://github.com/libgit2/libgit2 mylibgit
----
Each file in your working directory can be in one of two states: tracked
untracked
----
Tracked: files that were in the last snapshot; they can be unmodified, modified, or staged.
Untracked: everything else – any files in your working directory that were not in your last snapshot and are not in your staging area.
----
When you first clone a repository, all of your files will be tracked and unmodified because you just checked them out and haven't edited anything.
----
As you edit files, Git sees them as modified, because you've changed them since your last commit.
You stage these modified files and then commit all your staged changes, and the cycle repeats.
---
To determine which files are in which state:
git status
git status -s
git status --short

New files not tracked have a ??.
New files added to the staging area have an A.
Modified files have an M.
---
To track and stage a file or directory:
git add [file or directory]

example:
git add README
----
If you modify a file after you run "git add", you have to run "git add" again to stage the latest version of the file.
----
To ignore files:
create a file named .gitignore.
example:

$ cat .gitignore

# To ignore any files ending in “.o” or “.a”
*.[oa]

# To ignore all files that end with a tilde (~)
*~
----
The rules for the .gitignore file:
Blank lines or lines starting with # are ignored.
Standard glob patterns work.
You can start patterns with a forward slash (/) to avoid recursivity.
You can end patterns with a forward slash (/) to specify a directory.
You can negate a pattern by starting it with an exclamation point (!).
Glob patterns are simplified regular expressions.
An asterisk (*) matches zero or more characters;
[abc] matches any character inside the brackets (in this case a, b, or c);
a question mark (?) matches a single character;
brackets enclosing characters separated by a hyphen([0-9]) matches any character between them (in this case 0 through 9). You can also use two asterisks to match nested directories; a/**/z would match a/z, a/b/z, a/b/c/z, and so on.
----
Example .gitignore file:

# no .a files
*.a

# but do track lib.a, even though you're ignoring .a files above
!lib.a

# only ignore the TODO file in the current directory, not subdir/TODO
/TODO

# ignore all files in the build/ directory
build/

# ignore doc/notes.txt, but not doc/server/arch.txt
doc/*.txt

# ignore all .pdf files in the doc/ directory
doc/**/*.pdf
----
To show the lines added and removed (only changes that are still unstaged):
git diff
----
To see what you've staged that will go into your next commit:
git diff --staged

This command compares your staged changes to your last commit.
----
a graphical or external diff viewing program:
git difftool
----
To commit staged files:
git commit
----
To type your commit message inline:
git commit -m "your message"
----
To stage tracked files and commit:
git commit -a -m 'added new benchmarks'
----
To remove a file:
git rm

It also removes the file from your working directory so you don't see it as an untracked file the next time around.
----
To rename a file:
git mv file_from file_to
----
----
git log
with no arguments, git log lists the commits made in that repository in reverse chronological order
----
git log -p -2

-p: shows the difference introduced in each commit.
-2: limits the output to only the last two entries
----
to see some abbreviated stats for each commit:
git log --stat
----
git log --pretty=oneline

--pretty: changes the log output to formats other than the default.
oneline: prints each commit on a single line
----
format: allows you to specify your own log output format.
git log --pretty=format:"%h - %an, %ar : %s"
----
To try the last commit again:
git commit --amend

This command takes your staging area and uses it for the commit.
----
if you commit and then realize you forgot to stage the changes in a file you wanted to add to this commit:
git commit -m 'initial commit'
git add forgotten_file
git commit --amend

You end up with a single commit – the second commit replaces the results of the first.
----
To unstage:
git reset HEAD CONTRIBUTING.md

The CONTRIBUTING.md file is modified but once again unstaged.
----
Unmodifying a Modified File:
git checkout -- [file]

example:
git checkout -- CONTRIBUTING.md

Any changes you made to that file are gone – you just copied another file over it. Don’t ever use this command unless you absolutely know that you don’t want the file.
----
Remote repositories: versions of your project that are hosted on the Internet or network somewhere.
----
To see which remote servers you have configured:
git remote
----
To show the URLs that Git has stored for the shortname to be used when reading and writing to that remote:
git remote -v
origin    https://github.com/schacon/ticgit (fetch)
origin    https://github.com/schacon/ticgit (push)
----
To add a new remote Git repository:git remote add [shortname] [url]
----
To fetch all the information in the repository but that you don’t yet have in your repository:
git fetch [remote-name]

example:
git fetch origin

You should have references to all the branches from that remote, which you can merge in or inspect at any time.
----
If you clone a repository, the command automatically adds that remote repository under the name “origin”.

git fetch origin
It fetches any new work that has been pushed to that server since you cloned (or last fetched from) it.

git fetch
It pulls the data to your local repository – it doesn’t merge it with any of your work or modify what you’re currently working on.
You have to merge it manually into your work when you’re ready.
----
git pull
If you have a branch set up to track a remote branch, it fetches and merges a remote branch into your current branch.

git clone
It automatically sets up your local default branch (usually called "master") to track the remote default branch on the server you cloned from.

git pull
It fetches data from the server you cloned from and tries to merge it into the current branch.
----
To share, you have to push it upstream:
git push [remote-name] [branch-name]

To push your master branch to your origin server :
git push origin master
----
To see information about a  remote:
git remote show [remote-name]

example:
git remote show origin
----
To rename a reference:
git remote rename [old name] [new name]

example:
git remote rename pb paul

This changes your remote branch names, too.
What used to be referenced at pb/master is now at paul/master.
----
To remove a remote:
git remote rm [remote]

example:
git remote rm paul
----
Git has the ability to tag specific points in history as being important. Typically people use this functionality to mark release points (v1.0, and so on).
----
To list the tags in alphabetical order:
git tag
----
To list tags starting with 1.8.5:
git tag -l 'v1.8.5*'
----
Two main types of tags: lightweight and annotated.
lightweight: a pointer to a specific commit.
Annotated: full objects in the Git database. They’re checksummed; contain the tagger name, email, and date; have a tagging message; and can be signed and verified with GNU Privacy Guard (GPG).
----
To create an annotated tag:
git tag -a [name] -m '[message]'

example:
git tag -a v1.4 -m 'my version 1.4'
----
To create a lightweight tag, don’t supply the -a, -s, or -m option:
git tag [name]-lw

example:
git tag v1.4-lw
----
Branching means you diverge from the main line of development and continue to do work without messing with that main line.
----
To create a new branch:
git branch [name]

example:
git branch testing
----
HEAD: a pointer to the local branch you’re currently on.
----
To show where the branch pointers are pointing:
git log --oneline --decorate
----
To switch to an existing branch:
git checkout [another branch]

To switch back to the master branch:
git checkout master

Switching branches changes files in your working directory
----
To print out the history of your commits, showing where your branch pointers are and how your history has diverged:
git log --oneline --decorate --graph --all
----
To create a branch and switch to it at the same time
git checkout -b [new branch]

example:
git checkout -b iss53

This is shorthand for:
git branch iss53
git checkout iss53
----
To merge with current branch:
git merge [branch]
----
fast-forward:
When the commit pointed to by the branch you merged in is directly upstream of the commit you’re on, Git moves the pointer forward.
When you try to merge one commit with a commit that can be reached by following the first commit’s history, Git simplifies things by moving the pointer forward because there is no divergent work to merge together.
----
To delete a branch:
git branch -d [branch]
----
merge conflict:
If you changed the same part of the same file differently in the two branches you’re merging together, Git won’t be able to merge them.
----
To use a graphical tool to resolve merge conflict:
git mergetool
----
To list your branches:
git branch

Notice the * character that prefixes the branch: it indicates the current branch.
----
To see the last commit on each branch:
git branch -v
----
The useful --merged and --no-merged options can filter this list to branches that you have or have not yet merged into the branch you’re currently on.
----
To see the branches merged into the current branch:
git branch --merged

Branches on this list without the * in front of them can be deleted;
you’ve already incorporated their work into another branch, so you’re not going to lose anything.
----
To see all the branches that contain work you haven’t yet merged in:
git branch --no-merged
----

Wednesday, October 21, 2015

UNIX

--BEGIN--
UNIX
----
df: Display free disk space
du: Estimate file space usage
vmstat: Report virtual memory statistics
uname: Print system information
----
EDIT
bzip2:Compress or decompress named file(s)
gzip: Compress or decompress named file(s)
 zip: Package and compress (archive) files.
rev: Reverse lines of a file
awk: Find and Replace text, database sort/validate/index

  expand: Convert tabs to spaces
unexpand: Convert spaces to tabs

  rar: Archive files with compression
unrar: Extract files from a rar archive

head: Output the first part of file(s)
tail: Output the last part of file
----
ftp: File Transfer Protocol
sftp: Secure File Transfer Program
----
COMMANDS
if: Conditionally perform a command
continue: Resume the next iteration of a loop •
break: Exit from a loop •
case: Conditionally perform a command
while: Execute commands
until: Execute commands (until error)
command: Run a command - ignoring shell functions •
cron: Daemon to execute scheduled commands
crontab: Schedule a command to run at a later time
eval: Evaluate several commands/arguments
exec: Execute a command

read: Read a line from standard input •
readarray: Read from stdin into an array variable •
local: Create variables •
declare: Declare variables and give them attributes •
let: Perform arithmetic on shell variables •
readonly: Mark variables/functions as readonly

  set: Manipulate shell variables and functions
unset: Remove variable or function names
type: Describe a command •
true: Do nothing, successfully
----
USER
whoami: Print the current user id and name (`id -un')
users: List users currently logged in
who: Print all usernames currently logged in
passwd: Modify a user password
su: Substitute user identity
sudo: Execute a command as another user
useradd: Create new user account
userdel: Delete a user account
usermod: Modify user account
write: Send a message to another user
----
GROUP
groupdel: Delete a group
groupmod: Modify a group
chgrp: Change group ownership
chown: Change file owner and group
groupadd: Add a user security group
groups: Print group names a user is in
id: Print user and group id's
----
more: Display output one screen at a time
less: Display output one screen at a time
clear: Clear terminal screen
echo: Display message on screen •
----
NETWORK
ping: Test a network connection
netstat: Networking information
mtr: Network diagnostics (traceroute/ping)
ifconfig: Configure a network interface
ifup: Start a network interface up
ifdown: Stop a network interface
----
PRINTER
lpc: Line printer control program
lpr: Off line print
lprint: Print a file
lprintq: List the print queue
printcap: Printer capability database
pr: Prepare files for printing
----
PROCESS
top: List processes running on the system
ps: Process status
kill: Kill a process by specifying its PID
killall: Kill processes by name
fuser: Identify/kill the process that is accessing a file
htop: Interactive process viewer
pkill: Kill processes by a full or partial name.
wait: Wait for a process to complete •
----
mount: Mount a file system
umount: Unmount a device
----
FILES
stat: Display file or file system status
file: Determine file type
ls: List information about file(s)
lsof: List open files
cat: Concatenate and print (display) the content of files

cp: Copy one or more files to another location
rename: Rename files
rm: Remove files

sort: Sort text files
sum: Print a checksum for a file

cmp:  Compare two files
comm: Compare two sorted files line by line

chmod: Change access permissions
dd: Convert and copy a file, write disk headers, boot records

locate:  Find files
slocate: Find files
find: Search for files that meet a desired criteria
grep:  Search file(s) for lines that match a given pattern
fgrep: Search file(s) for lines that match a fixed string
egrep: Search file(s) for lines that match an extended expression
----
basename: Strip directory and suffix from filenames

split:  Split a file into fixed-size pieces
csplit: Split a file into context-determined pieces
cut: Divide a file into several parts

diff: Display the differences between two files
diff3: Show differences among three files
----
JOB
fg: Send job to foreground
bg: Send to background
jobs: List active jobs •
lprintd: Abort a print job
lprm: Remove jobs from the print queue
nice: Set the priority of a command or job
renice: Alter priority of running processes
----
ENVIRONMENT
printenv: Print environment variables
export: Set an environment variable
env: Environment variables
----
DIRECTORY
pwd: Print Working Directory
cd: Change Directory
mkdir: Create new directory
rmdir: Remove directory
mv: Move or rename files or directories
dir: Briefly list directory contents
vdir: Verbosely list directory contents (`ls -l -b')
v:    Verbosely list directory contents (`ls -l -b')
----
exit: Exit the shell
logout: Exit a login shell •
return: Exit a shell function
suspend: Suspend execution of this shell •
shutdown: Shutdown or restart linux
reboot: Reboot the system
----
hostname: Print or set system name
logname: Print current login name
---
history: Command History
man: Help manual
help: Display help for a built-in command •
apropos: Search Help manual pages (man -k)
----
TOOLS
cal: Display a calendar
date: Display or change the date & time
dc: Desk Calculator
aspell: Spell Checker
bc: Arbitrary precision calculator language
ddrescue: Data recovery tool
vi: Text Editor
----
alias:   Create an alias •
unalias: Remove an alias •
----
apt-get:  Search for and install software packages (Debian/Ubuntu)
aptitude: Search for and install software packages (Debian/Ubuntu)

bash: GNU Bourne-Again SHell
builtin: Run a shell builtin

cfdisk: Partition table manipulator for Linux

chroot: Run a command with a different root directory
chkconfig: System services (runlevel)
cksum: Print CRC checksum and byte counts
----
dig: DNS lookup
dircolors: Colour setup for `ls'
dirname: Convert a full pathname to just a path
dirs: Display list of remembered directories
dmesg: Print kernel & driver messages
eject: Eject removable media
enable: Enable and disable builtin shell commands •

ethtool: Ethernet card settings

expect: Automate arbitrary applications accessed over a terminal

expr: Evaluate expressions
false: Do nothing, unsuccessfully
fdformat: Low-level format a floppy disk
fdisk: Partition table manipulator for Linux
fmt: Reformat paragraph text
fold: Wrap text to fit a specified width.
for: Expand words, and execute commands
format: Format disks or tapes
free: Display memory usage
fsck: File system consistency check and repair

function: Define Function Macros

gawk: Find and Replace text within file(s)
getopts: Parse positional parameters
hash: Remember the full pathname of a name argument

iconv: Convert the character set of a file
----
import: Capture an X server screen and save the image to file
install: Copy files and set attributes
ip: Routing, devices and tunnels

join: Join lines on a common field

link: Create a link to a file
ln: Create a symbolic link to a file
look: Display lines beginning with a given string

make: Recompile a group of programs
mkfifo: Make FIFOs (named pipes)
mkisofs: Create an hybrid ISO9660/JOLIET/HFS filesystem
mknod: Make block or character special files
most: Browse or page through a text file

mtools: Manipulate MS-DOS files
mmv: Mass Move and rename (files)

nl: Number lines and write files
nohup: Run a command immune to hangups
notify-send: Send desktop notifications
nslookup: Query Internet name servers interactively
open: Open a file in its default application
op: Operator access
paste: Merge lines of files
pathchk: Check file name portability
----
popd: Restore the previous value of the current directory
pushd: Save and then change the current directory
----
printf: Format and print data •

pv: Monitor the progress of data through a pipe
----
quota: Display disk usage and limits
quotacheck: Scan a file system for disk usage
quotactl: Set disk quotas
----
ram: ram disk device
rcp: Copy files between two machines

remsync: Synchronize remote files via email
rsync: Remote file copy (Synchronize file trees)
screen: Multiplex terminal, run remote shells via ssh
scp: Secure copy (remote file copy)
sdiff: Merge two files interactively
sed: Stream Editor
select: Accept keyboard input
seq: Print numeric sequences
shift: Shift positional parameters
shopt: Shell Options
sleep: Delay for a specified time
source: Run commands from a file '.'
ssh: Secure Shell client (remote login program)
strace: Trace system calls and signals

sync: Synchronize data on disk with memory
tar: Store, list or extract files in an archive
tee: Redirect output to multiple files
test: Evaluate a conditional expression
time: Measure Program running time
timeout: Run a command with a time limit
times: User and system times
touch: Change file timestamps

tput: Set terminal-dependent capabilities, color, position
traceroute: Trace Route to Host
trap: Run a command when a signal is set(bourne)
tr: Translate, squeeze, and/or delete characters
tsort: Topological sort
tty: Print filename of terminal on stdin
ulimit: Limit user resources •
umask: Users file creation mask

uniq: Uniquify files
units: Convert units from one scale to another

unshar: Unpack shell archive scripts
uptime: Show uptime
----
uuencode: Encode a binary file
uudecode: Decode a file created by uuencode
----
watch: Execute/display a program periodically
wc: Print byte, word, and line counts
whereis: Search the user's $path, man pages and source files for a

program
which: Search the user's $path for a program file

wget: Retrieve web pages or files via HTTP, HTTPS or FTP

xargs: Execute utility, passing constructed argument list(s)
xdg-open: Open a file or URL in the user's preferred application.
yes: Print a string until interrupted
.: Run a command script in the current shell
!!: Run the last command again
###: Comment / Remark

Commands marked • are bash built-ins
----
CLI: command line interfaces.
bash:Bourne Again SHell
----
superuser:the last character of your shell prompt is #
superuser has administrative privileges.
----
To copy and paste with the mouse:
1. select text
2. press the middle mouse button
---
pwd (print working directory)
cd (change directory)
ls (list files and directories)
----
On most systems, your home directory is:/home/your_user_name
----
The "." notation refers to the working directory itself
The ".." notation refers to the working directory's parent

directory.
----
Change to the parent directory:
cd ..
----
Change to the a directory called "bin" under the current

directory:
cd bin
----
change to your home directory:
cd
----
change to the home directory of the specified user:
cd ~user_name
----
changes to the previous directory:
cd -
----
File names that begin with a period character are hidden.
ls will not list them unless you say ls -a.
----
File names are case sensitive.
----
Though Linux supports long file names which may contain embedded

spaces and punctuation characters, limit the punctuation

characters to period, dash, and underscore. Most importantly, do

not embed spaces in file names. If you want to represent spaces

between words in a file name, use underscore characters.
----
ls (list files and directories)
less (view text files)
file (classify a file's contents)
----
List the files in the /bin directory:
ls /bin
---
List the files in the working directory in long format
ls -l
----
List the files in the /bin and /etc directory in long format:
ls -l /etc /bin   
----
List all files (even hidden) in the parent directory in long

format:

ls -la ..   
----
Group:The name of the group that has file permissions in addition

to the file's owner.
Owner:The name of the user who owns the file.
File Permissions: A representation of the file's access

permissions.
"-" :regular file
"d" :directory
The second set of three characters represent the read, write, and

execution rights of the file's owner.
The next three represent the rights of the file's group.
The final three represent the rights granted to everybody else.
----
less [text_file]
to view text files one page at a time.

Page Up or b: Scroll back one page
Page Down or space: Scroll forward one page
q: to exit
G: Go to the end of the text file
1G:Go to the beginning of the text file
/characters: Search forward in the text file for an occurrence of

the specified characters
n: Repeat the previous search
h: Display a complete list less commands and options
----
file [name_of_file]
to determine what kind of data a file contains

Monday, September 7, 2015

What is the difference between が and は?

What is the difference between が and は?

This question gets asked again and again, and what is worse, nobody seems to be able to come up with a simple, good answer.

これは本だ。(kore wa hon da) This is a book.
これが本だ。(kore ga hon da) This one is the book.

は is used to make a flat statement, without emphasis.
が is used to put emphasis in the preceding word.

それは何ですか? (sore wa nan desu ka) What is that?
これは本だ。(kore wa hon da) This is a book.

どれが本ですか?(dore ga hon desu ka)? Which one is the book?
これが本だ。(kore ga hon da) This one is the book.

They are not interchangeable, they have different meanings.
は and が often indicate the subject of the sentence, but not always.
That is probably the source of all confusion.
Maybe it is better to think that they have nothing to do with the subject.

は usually indicates the topic of the sentence.
The topic of the sentence is what the sentence is talking about, which is not necessarily the subject.
Let's see an example:

コーヒーは毎日飲んでいます。kōhī wa mainichi nonde imasu.
Speaking of coffee, I drink it every day.

When I say "コーヒーは", it means that I am going to talk about coffee.
As long as I don't change the topic, all subsequent sentences will all be about coffee. But coffee may not necessarily be the subject of the sentence.

Speaking of coffee,
I drink it every day
I love it,
I think it is delicious.

コーヒーは (kōhī wa)
毎日飲んでいますし、 (mainichi nonde imasu shi)
大好きだし、 (dai suki da shi)
とても美味しいと思います。 (totemo oshii to omoimasu)

Coffee is not the subject of the sentence. But all sentences after コーヒーは talk about coffee. Coffee is the topic of the sentences.
The subject is the pronoun "I" which can be omitted because it is obvious who the subject is.

Another example:

Speaking of Mr. Tanaka,
his house is tiny
but his dog is enormous.

田中さんは (Tanaka san wa)
家がとても小さいけど、 (uchi ga totemo chiisai kedo)
犬が凄く大きい。 (inu ga sugoku ookii)

Mr. Tanaka is neither the subject nor object of the sentences. But we are talking about his house and his dog, so he is the topic of the sentences.
The particle は has nothing to do with the subject or object of the sentence.

Both sentences below are acceptable:
田中さんの犬が大きい。(Tanaka san no inu ga ookii) Mr. Tanaka's dog is big.
田中さんは犬が大きい。 (Tanaka san wa inu ga ookii) Speaking of Mr. Tanaka, his dog is big.