about summary refs log tree commit diff stats
path: root/linux/bash.html
blob: f49d27ec1b86e89baaa675f1587d6a9bd3a598de (plain) (blame)
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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
<!DOCTYPE html>
<html dir="ltr" lang="en">
    <head>
        <meta charset='utf-8'>
        <title>2.5.2. Bash</title>
    </head>
    <body>
        <a href="index.html">Core OS Index</a>

        <h1 id="bash">2.5.2. Bash</h1>

        <p>Just to be sure, setup bash as default login;<p>

        <pre>
        $ chsh
        </pre>

        <p>Description of configuration files;</p>

        <dl>
            <dt>~/.bash_profile</dt>
            <dd>Minimal file that just load .profile and then .bashrc,
            in this order.</dd>

            <dt>~/.profile<dt>
            <dd>Not specifically related to bash, such as
            environment variables (PATH). Only for login shells (sh)
            or graphical applications.</dd>

            <dt>~/.bashrc</dt>
            <dd>Related to interactive command line, such as bash
            alias, editor.</dd>
        </dl>

        <h2 id="profile">2.5.2.1. Profile</h2>

        <p>Example of ~/.profile;</p>

        <pre>
	export GPG_AGENT_INFO  # the env file does not contain the export statement
	export SSH_AUTH_SOCK   # enable gpg-agent for ssh

	export GPGKEY=XXXXXXXX

	# ssh-agent to ask only ounce for password
	SSH_ENV="$HOME/.ssh/environment"
	function start_agent {
	    echo "Initialising new SSH agent..."
	    /usr/bin/ssh-agent | sed 's/^echo/#echo/' > "${SSH_ENV}"
	    echo succeeded
	    chmod 600 "${SSH_ENV}"
	    . "${SSH_ENV}" > /dev/null
	    /usr/bin/ssh-add;
	}

	# Source SSH settings, if applicable
	if [ -f "${SSH_ENV}" ]; then
	    . "${SSH_ENV}" > /dev/null
	    #ps ${SSH_AGENT_PID} doesn't work under cywgin
	    ps -ef | grep ${SSH_AGENT_PID} | grep ssh-agent$ > /dev/null || {
		start_agent;
	    }
	else
	    start_agent;
	fi

	# Weston
	if test -z "${XDG_RUNTIME_DIR}"; then
	    export XDG_RUNTIME_DIR=/tmp/${UID}-runtime-dir
	    if ! test -d "${XDG_RUNTIME_DIR}"; then
		mkdir "${XDG_RUNTIME_DIR}"
		chmod 0700 "${XDG_RUNTIME_DIR}"
	    fi
fi        </pre>

        <h2 id="bashrc">2.5.2.2. Bash RC</h2>

        <p>Example of ~/.bashrc;</p>

        <pre>
        # If not running interactively, don't do anything
        case $- in
                *i*) ;;
                *) return;;
        esac


        # check the window size after each command and, if necessary,
        # update the values of LINES and COLUMNS.
        shopt -s checkwinsize


        # don't put duplicate lines or lines starting with space in the history.
        # See bash(1) for more options
        HISTCONTROL=ignoreboth

        # append to the history file, don't overwrite it
        shopt -s histappend

        # for setting history length see HISTSIZE and HISTFILESIZE in bash(1)
        HISTSIZE=1000
        HISTFILESIZE=2000

        alias tmux="tmux -2"

        alias rm='rm -i'
        #alias cp='cp -i'
        alias mv='mv -i'
        # Prevents accidentally clobbering files.
        alias mkdir='mkdir -p'

        alias h='history'
        alias j='jobs -l'
        alias which='type -a'
        alias ..='cd ..'

        # Generate a password
        genpasswd () {
            local l=$1
            [ "$l" == "" ] && l=20
            tr -dc A-Za-z0-9_ &lt; /dev/urandom | head -c ${l} | xargs
        }

        # Git graph log
        glog () {
            git log --graph --abbrev-commit --decorate --date=relative --all
        }

        if [[ -z "$TMUX" ]] ;then
            ID="`tmux ls | grep -vm1 attached | cut -d: -f1`" # get the id of a deattached session
            if [[ -z "$ID" ]] ;then # if not available create a new one
                tmux new-session
            else
                tmux attach-session -t "$ID" # if available attach to it
            fi
        fi
        </pre>

        <h2 id="bash_profile">2.5.2.3. Bash profile</h2>

        <p>Example of ~/.bash_profile;</p>

        <pre>
                #!/bin/bash
                if [ -f ~/.profile ]; then
                   source ~/.profile
                fi

                if [ -f ~/.bashrc ]; then
                   source ~/.bashrc
                fi
        </pre>


        <a href="index.html">Core OS Index</a>
        <p>
        This is part of the Tribu System Documentation.
        Copyright (C) 2020
        Tribu Team.
        See the file <a href="../fdl-1.3-standalone.html">Gnu Free Documentation License</a>
        for copying conditions.</p>


    </body>
</html>
= lineNum.substr(1); /* strip off '#' */ if (lineNum.indexOf('L') == -1) { lineNum = 'L'+lineNum; } var lineElem = document.getElementById(lineNum); /* Always jump to new location even if the line was hidden inside a fold, or * we corrected the raw number to a line ID. */ if (lineElem) { lineElem.scrollIntoView(true); } return true; } if ('onhashchange' in window) { window.onhashchange = JumpToLine; } --> </script> </head> <body onload='JumpToLine();'> <a href='https://github.com/akkartik/mu/blob/master/125write-stream-data.subx'>https://github.com/akkartik/mu/blob/master/125write-stream-data.subx</a> <pre id='vimCodeElement'> <span id="L1" class="LineNr"> 1 </span>== code <span id="L2" class="LineNr"> 2 </span><span class="subxComment"># instruction effective address register displacement immediate</span> <span id="L3" class="LineNr"> 3 </span><span class="subxS1Comment"># . op subop mod rm32 base index scale r32</span> <span id="L4" class="LineNr"> 4 </span><span class="subxS1Comment"># . 1-3 bytes 3 bits 2 bits 3 bits 3 bits 3 bits 2 bits 2 bits 0/1/2/4 bytes 0/1/2/4 bytes</span> <span id="L5" class="LineNr"> 5 </span> <span id="L6" class="LineNr"> 6 </span><span class="subxComment"># write an entire stream's contents to a buffered-file</span> <span id="L7" class="LineNr"> 7 </span><span class="subxComment"># ways to do this:</span> <span id="L8" class="LineNr"> 8 </span><span class="subxComment"># - construct a 'maximal slice' and pass it to write-slice-buffered</span> <span id="L9" class="LineNr"> 9 </span><span class="subxComment"># - flush the buffered-file and pass the stream directly to its fd (disabling buffering)</span> <span id="L10" class="LineNr"> 10 </span><span class="subxComment"># we'll go with the first way for now</span> <span id="L11" class="LineNr"> 11 </span><span class="subxFunction">write-stream-data</span>: <span class="subxComment"># f: (addr buffered-file), s: (addr stream byte)</span> <span id="L12" class="LineNr"> 12 </span> <span class="subxS1Comment"># . prologue</span> <span id="L13" class="LineNr"> 13 </span> 55/push-ebp <span id="L14" class="LineNr"> 14 </span> 89/copy 3/mod/direct 5/rm32/ebp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 4/r32/esp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="subxComment"># copy esp to ebp</span> <span id="L15" class="LineNr"> 15 </span> <span class="subxS1Comment"># . save registers</span> <span id="L16" class="LineNr"> 16 </span> 50/push-eax <span id="L17" class="LineNr"> 17 </span> 51/push-ecx <span id="L18" class="LineNr"> 18 </span> 56/push-esi <span id="L19" class="LineNr"> 19 </span> <span class="subxComment"># esi = s</span> <span id="L20" class="LineNr"> 20 </span> 8b/copy 1/mod/*+disp8 5/rm32/ebp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 6/r32/esi 0xc/disp8 <span class="Normal"> . </span> <span class="subxComment"># copy *(ebp+12) to esi</span> <span id="L21" class="LineNr"> 21 </span> <span class="subxComment"># var slice/ecx: slice = {s-&gt;data, &amp;s-&gt;data[s-&gt;write]}</span> <span id="L22" class="LineNr"> 22 </span> <span class="subxS1Comment"># . push &amp;s-&gt;data[s-&gt;write]</span> <span id="L23" class="LineNr"> 23 </span> 8b/copy 0/mod/indirect 6/rm32/esi <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 0/r32/eax <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="subxComment"># copy *esi to eax</span> <span id="L24" class="LineNr"> 24 </span> 8d/copy-address 1/mod/*+disp8 4/rm32/sib 6/base/esi 0/index/eax <span class="Normal"> . </span> 0/r32/eax 0xc/disp8 <span class="Normal"> . </span> <span class="subxComment"># copy esi+eax+12 to eax</span> <span id="L25" class="LineNr"> 25 </span> 50/push-eax <span id="L26" class="LineNr"> 26 </span> <span class="subxS1Comment"># . push s-&gt;data</span> <span id="L27" class="LineNr"> 27 </span> 8d/copy-address 1/mod/*+disp8 6/rm32/esi <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 0/r32/eax 0xc/disp8 <span class="Normal"> . </span> <span class="subxComment"># copy esi+12 to eax</span> <span id="L28" class="LineNr"> 28 </span> 50/push-eax <span id="L29" class="LineNr"> 29 </span> <span class="subxS1Comment"># . ecx = esp</span> <span id="L30" class="LineNr"> 30 </span> 89/copy 3/mod/direct 1/rm32/ecx <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 4/r32/esp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="subxComment"># copy esp to ecx</span> <span id="L31" class="LineNr"> 31 </span> <span class="subxComment"># write-slice-buffered(f, slice)</span> <span id="L32" class="LineNr"> 32 </span> <span class="subxS2Comment"># . . push args</span> <span id="L33" class="LineNr"> 33 </span> 51/push-ecx <span id="L34" class="LineNr"> 34 </span> ff 6/subop/push 1/mod/*+disp8 5/rm32/ebp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 8/disp8 <span class="Normal"> . </span> <span class="subxComment"># push *(ebp+8)</span> <span id="L35" class="LineNr"> 35 </span> <span class="subxS2Comment"># . . call</span> <span id="L36" class="LineNr"> 36 </span> e8/call <a href='123slice.subx.html#L908'>write-slice-buffered</a>/disp32 <span id="L37" class="LineNr"> 37 </span> <span class="subxS2Comment"># . . discard args</span> <span id="L38" class="LineNr"> 38 </span> 81 0/subop/add 3/mod/direct 4/rm32/esp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 8/imm32 <span class="subxComment"># add to esp</span> <span id="L39" class="LineNr"> 39 </span><span class="Constant">$write-stream-data:end</span>: <span id="L40" class="LineNr"> 40 </span> <span class="subxS1Comment"># . restore locals</span> <span id="L41" class="LineNr"> 41 </span> 81 0/subop/add 3/mod/direct 4/rm32/esp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 8/imm32 <span class="subxComment"># add to esp</span> <span id="L42" class="LineNr"> 42 </span> <span class="subxS1Comment"># . restore registers</span> <span id="L43" class="LineNr"> 43 </span> 5e/pop-to-esi <span id="L44" class="LineNr"> 44 </span> 59/pop-to-ecx <span id="L45" class="LineNr"> 45 </span> 58/pop-to-eax <span id="L46" class="LineNr"> 46 </span> <span class="subxS1Comment"># . epilogue</span> <span id="L47" class="LineNr"> 47 </span> 89/copy 3/mod/direct 4/rm32/esp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 5/r32/ebp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="subxComment"># copy ebp to esp</span> <span id="L48" class="LineNr"> 48 </span> 5d/pop-to-ebp <span id="L49" class="LineNr"> 49 </span> c3/return <span id="L50" class="LineNr"> 50 </span> <span id="L51" class="LineNr"> 51 </span><span class="subxTest">test-write-stream-data</span>: <span id="L52" class="LineNr"> 52 </span> <span class="subxS1Comment"># . prologue</span> <span id="L53" class="LineNr"> 53 </span> 55/push-ebp <span id="L54" class="LineNr"> 54 </span> 89/copy 3/mod/direct 5/rm32/ebp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 4/r32/esp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="subxComment"># copy esp to ebp</span> <span id="L55" class="LineNr"> 55 </span> <span class="subxComment"># setup</span> <span id="L56" class="LineNr"> 56 </span> <span class="subxS1Comment"># . clear-stream(_test-output-stream)</span> <span id="L57" class="LineNr"> 57 </span> <span class="subxS2Comment"># . . push args</span> <span id="L58" class="LineNr"> 58 </span> 68/push <a href='115write-byte.subx.html#L285'>_test-output-stream</a>/imm32 <span id="L59" class="LineNr"> 59 </span> <span class="subxS2Comment"># . . call</span> <span id="L60" class="LineNr"> 60 </span> e8/call <a href='106stream.subx.html#L17'>clear-stream</a>/disp32 <span id="L61" class="LineNr"> 61 </span> <span class="subxS2Comment"># . . discard args</span> <span id="L62" class="LineNr"> 62 </span> 81 0/subop/add 3/mod/direct 4/rm32/esp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 4/imm32 <span class="subxComment"># add to esp</span> <span id="L63" class="LineNr"> 63 </span> <span class="subxS1Comment"># . clear-stream($_test-output-buffered-file-&gt;buffer)</span> <span id="L64" class="LineNr"> 64 </span> <span class="subxS2Comment"># . . push args</span> <span id="L65" class="LineNr"> 65 </span> 68/push $_test-output-buffered-file-&gt;buffer/imm32 <span id="L66" class="LineNr"> 66 </span> <span class="subxS2Comment"># . . call</span> <span id="L67" class="LineNr"> 67 </span> e8/call <a href='106stream.subx.html#L17'>clear-stream</a>/disp32 <span id="L68" class="LineNr"> 68 </span> <span class="subxS2Comment"># . . discard args</span> <span id="L69" class="LineNr"> 69 </span> 81 0/subop/add 3/mod/direct 4/rm32/esp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 4/imm32 <span class="subxComment"># add to esp</span> <span id="L70" class="LineNr"> 70 </span> <span class="subxS1Comment"># . clear-stream(_test-input-stream)</span> <span id="L71" class="LineNr"> 71 </span> <span class="subxS2Comment"># . . push args</span> <span id="L72" class="LineNr"> 72 </span> 68/push <a href='112read-byte.subx.html#L331'>_test-input-stream</a>/imm32 <span id="L73" class="LineNr"> 73 </span> <span class="subxS2Comment"># . . call</span> <span id="L74" class="LineNr"> 74 </span> e8/call <a href='106stream.subx.html#L17'>clear-stream</a>/disp32 <span id="L75" class="LineNr"> 75 </span> <span class="subxS2Comment"># . . discard args</span> <span id="L76" class="LineNr"> 76 </span> 81 0/subop/add 3/mod/direct 4/rm32/esp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 4/imm32 <span class="subxComment"># add to esp</span> <span id="L77" class="LineNr"> 77 </span> <span class="subxComment"># initialize input</span> <span id="L78" class="LineNr"> 78 </span> <span class="subxS1Comment"># . write(_test-input-stream, &quot;abcd&quot;)</span> <span id="L79" class="LineNr"> 79 </span> <span class="subxS2Comment"># . . push args</span> <span id="L80" class="LineNr"> 80 </span> 68/push <span class="Constant">&quot;abcd&quot;</span>/imm32 <span id="L81" class="LineNr"> 81 </span> 68/push <a href='112read-byte.subx.html#L331'>_test-input-stream</a>/imm32 <span id="L82" class="LineNr"> 82 </span> <span class="subxS2Comment"># . . call</span> <span id="L83" class="LineNr"> 83 </span> e8/call <a href='108write.subx.html#L24'>write</a>/disp32 <span id="L84" class="LineNr"> 84 </span> <span class="subxS2Comment"># . . discard args</span> <span id="L85" class="LineNr"> 85 </span> 81 0/subop/add 3/mod/direct 4/rm32/esp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 8/imm32 <span class="subxComment"># add to esp</span> <span id="L86" class="LineNr"> 86 </span> <span class="subxComment"># write-stream-data(_test-output-buffered-file, _test-input-stream)</span> <span id="L87" class="LineNr"> 87 </span> <span class="subxS2Comment"># . . push args</span> <span id="L88" class="LineNr"> 88 </span> 68/push <a href='112read-byte.subx.html#L331'>_test-input-stream</a>/imm32 <span id="L89" class="LineNr"> 89 </span> 68/push <a href='115write-byte.subx.html#L423'>_test-output-buffered-file</a>/imm32 <span id="L90" class="LineNr"> 90 </span> <span class="subxS2Comment"># . . call</span> <span id="L91" class="LineNr"> 91 </span> e8/call <a href='125write-stream-data.subx.html#L11'>write-stream-data</a>/disp32 <span id="L92" class="LineNr"> 92 </span> <span class="subxS2Comment"># . . discard args</span> <span id="L93" class="LineNr"> 93 </span> 81 0/subop/add 3/mod/direct 4/rm32/esp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 8/imm32 <span class="subxComment"># add to esp</span> <span id="L94" class="LineNr"> 94 </span> <span class="subxComment"># check that the write happened as expected</span> <span id="L95" class="LineNr"> 95 </span> <span class="subxS1Comment"># . flush(_test-output-buffered-file)</span> <span id="L96" class="LineNr"> 96 </span> <span class="subxS2Comment"># . . push args</span> <span id="L97" class="LineNr"> 97 </span> 68/push <a href='115write-byte.subx.html#L423'>_test-output-buffered-file</a>/imm32 <span id="L98" class="LineNr"> 98 </span> <span class="subxS2Comment"># . . call</span> <span id="L99" class="LineNr"> 99 </span> e8/call <a href='115write-byte.subx.html#L81'>flush</a>/disp32 <span id="L100" class="LineNr">100 </span> <span class="subxS2Comment"># . . discard args</span> <span id="L101" class="LineNr">101 </span> 81 0/subop/add 3/mod/direct 4/rm32/esp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 4/imm32 <span class="subxComment"># add to esp</span> <span id="L102" class="LineNr">102 </span> <span class="subxS1Comment"># . check-stream-equal(_test-output-stream, &quot;abcd&quot;, msg)</span> <span id="L103" class="LineNr">103 </span> <span class="subxS2Comment"># . . push args</span> <span id="L104" class="LineNr">104 </span> 68/push <span class="Constant">&quot;F - test-write-stream-data&quot;</span>/imm32 <span id="L105" class="LineNr">105 </span> 68/push <span class="Constant">&quot;abcd&quot;</span>/imm32 <span id="L106" class="LineNr">106 </span> 68/push <a href='115write-byte.subx.html#L285'>_test-output-stream</a>/imm32 <span id="L107" class="LineNr">107 </span> <span class="subxS2Comment"># . . call</span> <span id="L108" class="LineNr">108 </span> e8/call <a href='109stream-equal.subx.html#L194'>check-stream-equal</a>/disp32 <span id="L109" class="LineNr">109 </span> <span class="subxS2Comment"># . . discard args</span> <span id="L110" class="LineNr">110 </span> 81 0/subop/add 3/mod/direct 4/rm32/esp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 0xc/imm32 <span class="subxComment"># add to esp</span> <span id="L111" class="LineNr">111 </span> <span class="subxS1Comment"># . epilogue</span> <span id="L112" class="LineNr">112 </span> 89/copy 3/mod/direct 4/rm32/esp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="Normal"> . </span> 5/r32/ebp <span class="Normal"> . </span> <span class="Normal"> . </span> <span class="subxComment"># copy ebp to esp</span> <span id="L113" class="LineNr">113 </span> 5d/pop-to-ebp <span id="L114" class="LineNr">114 </span> c3/return </pre> </body> </html> <!-- vim: set foldmethod=manual : -->